@thednp/dommatrix 3.0.5 → 3.0.6

package/CHANGELOG.md

@@ -0,0 +1,40 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [3.0.6] - 2026-08-04
+- The `README.md` now documents installing from JSR (`jsr add @thednp/dommatrix`).
+
+## [3.0.5] - 2026-08-04
+
+### Added
+
+- JSDoc coverage for every public class member (the `m11`–`m44` and `a`–`f` properties plus all static helpers), so the generated documentation is complete.
+- A `deno.json` for JSR publishing (`@thednp/dommatrix@3.0.5`, `exports: "./src/index.ts"`) with Deno tasks mirroring the `package.json` scripts (`test`, `test-ui`, `clean-coverage`, `lint`, `check`, `format`, `fix`, `build`, `copy-docs`), the vitest/playwright dev dependencies declared via `npm:` specifiers in `imports`, and a `publish.include` list.
+- The GitHub Actions publish workflow now also publishes to JSR (`deno publish`).
+
+
+### Changed
+
+- Migrated the build from Vite + `vite-plugin-dts` to [tsdown](https://tsdown.dev) (rolldown-based). The `dist/` output files are unchanged (`dommatrix.mjs`, `dommatrix.cjs`, `dommatrix.js` UMD with the `CSSMatrix` global, plus sourcemaps), so `exports`, `main`, `module` and the `docs/` copy script keep working as-is.
+- The bundled `dist/dommatrix.d.ts` now contains the full type declarations (the Vite build emitted an empty `export { }` stub).
+- The helper types (`Matrix`, `Matrix3d`, `JSONMatrix`, `PointTuple`, `CSSMatrixInput`) are now exported from the package root, so `import type { Matrix } from "@thednp/dommatrix"` works.
+- `src/types.ts` now uses a type-only import (`import type CSSMatrix from "."`) to satisfy `deno lint`'s `verbatim-module-syntax` rule when `deno.json` is present.
+- Added `"type": "module"` to `package.json`, eliminating the Node `MODULE_TYPELESS_PACKAGE_JSON` ESM-reparse warning during builds. The `exports` map still routes `require` to the `.cjs` build, so CommonJS consumers are unaffected.
+- Renamed `tsdown.config.ts` to `tsdown.config.mts` and `vitest.config.ts` to `vitest.config.mts`, explicitly marking both as ESM.
+
+### Fixed
+
+- `transformPoint()` no longer references the `DOMPoint` global unconditionally — calling it in Node.js previously threw a `ReferenceError`. It now falls back to a plain `{ x, y, z, w }` tuple when `DOMPoint` is unavailable.
+- Initializing a matrix from a JSON object (`new CSSMatrix({...})`, `CSSMatrix.fromMatrix()`, `CSSMatrix.isCompatibleObject()`) no longer throws a `ReferenceError` in Node.js, where the `DOMMatrix` global does not exist.
+
+### Docs
+
+- Added `AGENTS.md` with guidance for AI agents working on this repository.
+- Added this `CHANGELOG.md`.
+- Added a "CSSMatrix vs native DOMMatrix" comparison section to the `README.md`.
+
+[3.0.5]: https://github.com/thednp/dommatrix/releases/tag/3.0.5

package/README.md

@@ -2,6 +2,7 @@
 
 [![Coverage Status](https://coveralls.io/repos/github/thednp/dommatrix/badge.svg)](https://coveralls.io/github/thednp/dommatrix)
 [![NPM Version](https://img.shields.io/npm/v/@thednp/dommatrix.svg)](https://www.npmjs.com/package/@thednp/dommatrix)
+[![JSR Version](https://img.shields.io/jsr/v/@thednp/dommatrix.svg)](https://jsr.io/@thednp/dommatrix)
 [![NPM Downloads](https://img.shields.io/npm/dm/@thednp/dommatrix.svg)](http://npm-stat.com/charts.html?@thednp/dommatrix)
 [![ci](https://github.com/thednp/dommatrix/actions/workflows/ci.yml/badge.svg)](https://github.com/thednp/dommatrix/actions/workflows/ci.yml)
 [![jsDelivr](https://data.jsdelivr.com/v1/package/npm/@thednp/dommatrix/badge)](https://www.jsdelivr.com/package/npm/@thednp/dommatrix)
@@ -17,8 +18,8 @@ A TypeScript sourced [DOMMatrix](https://developer.mozilla.org/en-US/docs/Web/AP
 - [API Reference](#api-reference)
 - [CSSMatrix vs native DOMMatrix](#cssmatrix-vs-native-dommatrix)
 - [Alternatives](#alternatives)
-- [Thanks](#thanks)
 - [History](#history)
+- [Thanks](#thanks)
 - [License](#license)
 
 ## Features
@@ -197,12 +198,6 @@ Methods of the `DOMMatrixReadOnly` prototype that are not part of this shim: `fl
 
 DOMMatrix shim is meant to be a light pocket tool for many things like [svg-path-commander](http://thednp.github.io/svg-path-commander). For a complete polyfill that fills in the missing `DOMMatrixReadOnly` methods (`inverse()`, `flipX()`, `flipY()`, ...), you might want to also consider [geometry-interfaces](https://github.com/trusktr/geometry-interfaces) and [geometry-polyfill](https://github.com/jarek-foksa/geometry-polyfill).
 
-## Thanks
-
-- Joe Pea for his [geometry-interfaces](https://github.com/trusktr/geometry-interfaces)
-- Jarek Foksa for his [geometry-polyfill](https://github.com/jarek-foksa/geometry-polyfill)
-- Arian Stolwijk for his [CSSMatrix](https://github.com/arian/CSSMatrix/)
-
 ## History
 
 `@thednp/dommatrix` started as a fork of the [original CSSMatrix](https://github.com/arian/CSSMatrix/). In contrast with the original source there have been a series of changes to the prototype for consistency, performance as well as requirements to better accommodate the **DOMMatrix** interface:
@@ -234,6 +229,12 @@ DOMMatrix shim is meant to be a light pocket tool for many things like [svg-path
 - *not supported* `flipX()` or `flipY()` instance methods of the *DOMMatrixReadOnly* prototype are not supported;
 - *not supported* `scaleNonUniformSelf()` or `rotate3d()` with `{x, y, z}` transform origin parameters are not implemented.
 
+## Thanks
+
+- Joe Pea for his [geometry-interfaces](https://github.com/trusktr/geometry-interfaces)
+- Jarek Foksa for his [geometry-polyfill](https://github.com/jarek-foksa/geometry-polyfill)
+- Arian Stolwijk for his [CSSMatrix](https://github.com/arian/CSSMatrix/)
+
 ## License
 
 DOMMatrix shim is [MIT Licensed](https://github.com/thednp/DOMMatrix/blob/master/LICENSE).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thednp/dommatrix",
-  "version": "3.0.5",
+  "version": "3.0.6",
   "description": "TypeScript shim for DOMMatrix",
   "homepage": "https://thednp.github.io/dommatrix/",
   "type": "module",
@@ -23,6 +23,7 @@
     "README.md",
     "AGENTS.md",
     "CLAUDE.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "repository": {