@afixt/screenshot-utils 0.9.0 → 1.0.0

package/CHANGELOG.md

@@ -1,11 +1,8 @@
 # Changelog
 
-All notable changes to this project will be documented in this file.
+All notable changes to this project will be documented in this file. See [standard-version](https://github.com/conventional-changelog/standard-version) for commit guidelines.
 
-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).
-
-## [Unreleased]
+## [1.0.0](https://github.com/AFixt/screenshot-utils/compare/v0.9.0...v1.0.0) (2026-05-29)
 
 ## [0.9.0] - 2026-05-22
 

package/README.md

@@ -2,7 +2,7 @@
 
 > Screenshot capture, transform, compose, tile, and redact utilities for the AFixt/Revenant accessibility platform.
 
-Status: **0.9.0** — Phases 0–4 of [`PLAN.md`](./PLAN.md) are complete; the full public API from [`spec.md`](./spec.md) § 8 is implemented and tested. Pre-1.0 while the v1.0.0 acceptance bar in `spec.md` § 23 is finished (OpenSeadragon e2e, 80% coverage, perf suite in CI). The API is expected to stay stable through to 1.0.0.
+Status: **0.9.0** — Phases 0–4 of [`PLAN.md`](./PLAN.md) are complete; the full public API from [`spec.md`](./spec.md) § 8 is implemented and tested (capture and transform at ≥90% line+branch coverage per § 23). Pre-1.0 while the remaining v1.0.0 acceptance items in `spec.md` § 23 land (a live CDP adapter test and the CI matrix running green). The API is expected to stay stable through to 1.0.0.
 
 This package owns **all** screenshot operations for the AFixt/Revenant platform: full-page, viewport, element, long-page strip-stitch, multi-viewport capture; crop / resize / convert / normalize transforms; annotate / heatmap / diff / composite; DZI tile pyramids; and PII redaction. It is being extracted from `@afixt/afixt-engine`; the engine will become a consumer.
 
@@ -40,27 +40,27 @@ Screenshot work was scattered across `afixt-engine`, `mortise`, and ad-hoc consu
 
 ## Install
 
-| Dependency          | Status                                         | Why you'd want it                      |
-| ------------------- | ---------------------------------------------- | -------------------------------------- |
-| `sharp`             | Required runtime dep — installed automatically | All raster operations                  |
-| `puppeteer` >=23    | Optional peer                                  | `fromPuppeteerPage` adapter            |
-| `playwright` >=1.40 | Optional peer                                  | `fromPlaywrightPage` adapter (Phase 2) |
-| `pixelmatch`        | Optional peer                                  | `diff()` function (Phase 4)            |
-| `pngjs`             | Optional peer                                  | `pixelmatch` co-dependency             |
-| `@napi-rs/canvas`   | Deferred to v1.1                               | Advanced annotation strokes            |
+| Dependency          | Status                                         | Why you'd want it            |
+| ------------------- | ---------------------------------------------- | ---------------------------- |
+| `sharp`             | Required runtime dep — installed automatically | All raster operations        |
+| `puppeteer` >=23    | Optional peer                                  | `fromPuppeteerPage` adapter  |
+| `playwright` >=1.40 | Optional peer                                  | `fromPlaywrightPage` adapter |
+| `pixelmatch`        | Optional peer                                  | `diff()` function            |
+| `pngjs`             | Optional peer                                  | `pixelmatch` co-dependency   |
+| `@napi-rs/canvas`   | Deferred to v1.1                               | Advanced annotation strokes  |
 
-Node `>=22.22.1` is required (`engine-strict=true`).
+Node `>=20.0.0` is required (`engine-strict=true`).
 
 ## PageAdapter
 
 The capture functions never import a browser. Consumers wrap their `Page`-like object:
 
 ```js
-const { fromPuppeteerPage } = require('@afixt/screenshot-utils/adapters/puppeteer');
+const { fromPuppeteerPage } = require('@afixt/screenshot-utils');
 const adapter = fromPuppeteerPage(page);
 ```
 
-Anything that satisfies the `PageAdapter` interface works — write your own for CDP-only runtimes. See `docs/adapters.md` (Phase 4) for the contract.
+Anything that satisfies the `PageAdapter` interface works — write your own for CDP-only runtimes. See `docs/adapters.md` for the contract.
 
 ## Capture functions
 
@@ -77,20 +77,20 @@ Anything that satisfies the `PageAdapter` interface works — write your own for
 - `convert(buffer, format, opts)` — re-encode
 - `resize(buffer, opts)` — fit, contain, cover
 - `normalize(buffer, opts)` — strip metadata, fix orientation
-- `annotate(buffer, annotations, opts)` — boxes, labels, severities (Phase 4)
-- `heatmap(buffer, points, opts)` — kernel-density overlay (Phase 4)
-- `diff(a, b, opts)` — pixelmatch-backed visual diff (Phase 4)
+- `annotate(buffer, annotations, opts)` — boxes, labels, severities
+- `heatmap(buffer, points, opts)` — kernel-density overlay
+- `diff(a, b, opts)` — pixelmatch-backed visual diff
 
 ## Tiling
 
-- `tileDzi(buffer, outDir | 'buffers', opts)` — produce a Deep Zoom Image pyramid (Phase 2)
+- `tileDzi(buffer, outDir | 'buffers', opts)` — produce a Deep Zoom Image pyramid
 
 ## Redaction
 
-- `redact(buffer, regions, mode, opts)` — blur, mask, or pixelate PII regions (Phase 4)
+- `redact(buffer, regions, mode, opts)` — blur, mask, or pixelate PII regions
 - `applyPiiPolicy(buffer, policy)` — apply a policy bundle for repeatable redaction
 
-## CLI (Phase 4)
+## CLI
 
 ```bash
 npx @afixt/screenshot-utils crop input.png --rect 0,0,400,300 --out thumb.png
@@ -103,11 +103,11 @@ npx @afixt/screenshot-utils diff before.png after.png --out diff.png
 - Pass `encoding: 'stream'` for memory-sensitive pipelines.
 - Use `cropMany` rather than calling `crop` in a loop — internally bounded parallelism is faster and uses less memory.
 - For long pages, prefer `captureLongPage` over a giant viewport — sharp handles strips better than 30 000-px-tall buffers.
-- See `docs/performance.md` (Phase 4) for ceilings.
+- See `docs/performance.md` for ceilings.
 
 ## Errors
 
-Every failure is a named class with a stable `code`, a structured `reason` enum, and a `retriable: boolean` hint. Hierarchy in `spec.md` § 14.1. Catalog in `docs/error-codes.md` (Phase 4).
+Every failure is a named class with a stable `code`, a structured `reason` enum, and a `retriable: boolean` hint. Hierarchy in `spec.md` § 14.1. Catalog in `docs/error-codes.md`.
 
 ## Versioning & non-goals
 

package/dist/index.js

@@ -16,7 +16,7 @@ var require_package = __commonJS({
   "package.json"(exports, module) {
     module.exports = {
       name: "@afixt/screenshot-utils",
-      version: "0.9.0",
+      version: "1.0.0",
       description: "Screenshot capture, transform, compose, tile, and redact utilities for the AFixt/Revenant accessibility platform",
       type: "commonjs",
       main: "./dist/index.js",
@@ -99,7 +99,7 @@ var require_package = __commonJS({
         access: "restricted"
       },
       engines: {
-        node: ">=22.22.1"
+        node: ">=20.0.0"
       },
       keywords: [
         "screenshot",
@@ -148,7 +148,7 @@ var require_package = __commonJS({
         "@commitlint/config-conventional": "20.5.3",
         "@eslint/js": "10.0.1",
         "@types/node": "22.19.19",
-        "@vitest/coverage-v8": "4.1.5",
+        "@vitest/coverage-istanbul": "4.1.5",
         "clean-jsdoc-theme": "4.3.2",
         eslint: "10.3.0",
         "eslint-plugin-import-x": "4.16.2",
@@ -167,6 +167,7 @@ var require_package = __commonJS({
         "lint-staged": "17.0.2",
         "markdownlint-cli": "0.48.0",
         "npm-run-all2": "8.0.4",
+        openseadragon: "6.0.2",
         pixelmatch: "7.1.0",
         playwright: "1.60.0",
         pngjs: "7.0.0",