@grundyjs/canvas-take 0.4.0 → 0.4.1

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.4.1 — 2026-10-28
+
+- Correct package homepage to the CanvasTake page; refresh package description, keywords and English/Russian README navigation and test instructions.
+
+- Browser CI tests in Chromium and Firefox exercise the real GIF module Worker, cancellation and a fresh export on the same page. Downloaded GIFs are independently decoded to verify pixels, dimensions, frame timings and loop count.
+
 ## 0.4.0 — 2026-10-26
 
 - Ready-made `gif/worker` adapter with a dedicated module Worker, transferable frames, request timeouts and cleanup on completion/cancellation/errors.

package/README.md

@@ -2,6 +2,8 @@
 
 [Русский](ru/README.md)
 
+[Website](https://grundyjs.ru/en/canvas-take/) · [npm](https://www.npmjs.com/package/@grundyjs/canvas-take) · [Issues](https://github.com/urffin/canvas-take/issues)
+
 Independent TypeScript library for HTML canvas video recording with optional audio tracks and offline GIF export through a separate entry point. No external runtime dependencies or dependency on AlgiViz. ESM only, with TypeScript declarations. MIT licensed. The package does not start or draw your animation.
 
 ## Install
@@ -27,7 +29,7 @@ recorder.dispose();
 
 Auto format order: WebM VP9, VP8, generic WebM, MP4. With audio, the VP9 and VP8 candidates include Opus. An explicit unsupported MIME fails without silently changing the format. The result reports the actual MIME and matching extension. FPS and bitrate are targets, not guarantees. durationMs measures recording wall time, not parsed file duration.
 
-Keep canvas bitmap dimensions fixed from start until stop. CSS scaling is allowed. Size changes fail the recording. Canvas must remain origin-clean. No screen capture, pause, frame-by-frame encoding or server upload. Chunks are retained in memory: the caller should limit duration. If background-tab throttling is unacceptable, the caller should dispose when the page becomes hidden. Codec support depends on the browser and available resources.
+Keep canvas bitmap dimensions fixed from start until stop. CSS scaling is allowed. Size changes fail the recording. Canvas must remain origin-clean. The video recorder does not support screen capture, pause, frame-by-frame video encoding or server upload. Chunks are retained in memory: the caller should limit duration. If background-tab throttling is unacceptable, the caller should dispose when the page becomes hidden. Codec support depends on the browser and available resources.
 
 Development: Node.js 22+, `npm install`, `npm test`, `npm pack`. ESM and declarations are emitted to dist. `npm pack` rebuilds automatically; `npm publish` runs tests before packing. The integration example expects AlgiViz in a sibling directory and is served by the included local server.
 
@@ -193,6 +195,10 @@ Recording requires a browser with `canvas.captureStream`, `MediaRecorder` and `M
 
 The integration example was verified with an actual VP9 recording at 1920×1080. This is not a promise that every browser can produce WebM or MP4. A canvas containing cross-origin content without CORS may not be captured.
 
+## Development checks
+
+Run `npm test` for unit and Node Worker tests, and `npm run test:package` for an isolated packed consumer. For real browser tests, first run `npx playwright install chromium firefox`, then `npm run test:browser`. These check GIF export, cancellation, a fresh export on the same page, Worker cleanup and independently decoded output. `npm run test:next` checks the packed library with Next.js/Turbopack. See [GIF verification details](docs/gif-encoder.md#verification).
+
 ## Release
 
 Run `npm test` and `npm run test:package` (packs and installs the tarball in an isolated consumer, then checks TypeScript declarations and runtime imports). The archive contains dist, README, LICENSE, CHANGELOG and package metadata. Source and issues: [urffin/canvas-take](https://github.com/urffin/canvas-take). The 0.x API may change in later minor releases.

package/docs/gif-encoder.md

@@ -33,6 +33,8 @@ The controller's optional `onProgress` observer works with every encoder. It rep
 
 ## Verification
 
+Run `npx playwright install chromium firefox` once, then `npm run test:browser`. The browser suite serves built modules with `worker-src 'self'`, observes actual Worker creation/closure, exports through a real canvas and downloads the GIF for independent decoding with gifuct-js. It checks every pixel, dimensions, frame count/durations, repeat count and progress events. An open-ended frame producer keeps the cancellation case active until the test clicks Cancel after observing a completed frame; no machine-speed-dependent delay is used. A second export on the same page must create and close a fresh Worker and produce the expected GIF. CI installs both browsers and retains the HTML report, GIF outputs, and failure screenshots/traces for seven days. These tests exercise direct module loading; the separate Next.js job covers bundler compilation.
+
 `npm run test:next` packs the local library and builds an isolated Next.js 16.3.0 / React 19.2.8 consumer with Turbopack. These are the site's installed versions at the time this fixture was added. Its client component uses the default Worker URL, export progress and cancellation under `worker-src 'self'`. The temporary directory is printed and retained for browser checks with the printed `npm start` command. A build pass alone does not establish browser execution or cancellation; verify those separately. This check does not modify the website checkout or publish a package. CI runs the build as a separate job.
 
 Tests use gifuct-js as an independent parser/LZW decoder, checking full pixel patches, dimensions, frame delays, long final holds, loop extension values, alpha composition and palette limits. Lifecycle tests cover pre-abort, abort/dispose during pending frame/finalization calls, late rejection, codec exceptions, tainted canvas, resize, empty exports, duplicate operations and exactly-once adapter disposal. Releasing references makes buffers eligible for garbage collection; tests do not claim a particular GC schedule.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@grundyjs/canvas-take",
-  "version": "0.4.0",
-  "description": "Record HTML canvas to video with explicit resource lifecycle",
+  "version": "0.4.1",
+  "description": "Record HTML canvas video with audio and export GIFs with pluggable encoders, Worker support and explicit resource cleanup",
   "type": "module",
   "files": [
     "dist",
@@ -40,9 +40,11 @@
     "prepack": "npm run build",
     "prepublishOnly": "npm test",
     "test:package": "node scripts/test-package.mjs",
-    "test:next": "node scripts/test-next.mjs"
+    "test:next": "node scripts/test-next.mjs",
+    "test:browser": "npm run build && playwright test"
   },
   "devDependencies": {
+    "@playwright/test": "1.64.1",
     "esbuild": "0.28.2",
     "gifenc": "1.0.3",
     "gifuct-js": "2.1.2",
@@ -53,12 +55,15 @@
     "name": "Grundy",
     "url": "https://grundyjs.ru/"
   },
-  "homepage": "https://grundyjs.ru/algorithms/insertion-sort/",
+  "homepage": "https://grundyjs.ru/canvas-take/",
   "keywords": [
     "canvas",
     "video",
     "recording",
     "mediarecorder",
+    "gif",
+    "audio",
+    "web-worker",
     "typescript"
   ],
   "sideEffects": false,

package/ru/README.md

@@ -2,6 +2,8 @@
 
 [English](../README.md)
 
+[Сайт](https://grundyjs.ru/canvas-take/) · [npm](https://www.npmjs.com/package/@grundyjs/canvas-take) · [Ошибки и предложения](https://github.com/urffin/canvas-take/issues)
+
 Независимая TypeScript-библиотека для записи видео с HTML canvas с необязательными
 аудиодорожками и покадрового экспорта GIF через отдельную точку входа. Без внешних
 зависимостей во время выполнения и без зависимости от AlgiViz. Только ESM,
@@ -301,6 +303,16 @@ AlgiViz и не изменяет тот проект.
 Это не обещание, что любой браузер создаст WebM или MP4. Canvas с содержимым
 из другого источника без CORS может оказаться недоступен для захвата.
 
+## Проверки при разработке
+
+`npm test` запускает модульные тесты и проверки Node Worker, а `npm run test:package`
+проверяет установку упакованной библиотеки в отдельный проект. Для настоящих браузеров
+сначала выполните `npx playwright install chromium firefox`, затем `npm run test:browser`.
+Проверяются GIF-экспорт, отмена, повторный экспорт на той же странице, завершение Worker
+и независимое декодирование результата. `npm run test:next` проверяет сборку
+упакованной библиотеки с Next.js/Turbopack. Подробности — в
+[описании проверок GIF](../docs/gif-encoder.md#verification).
+
 ## Выпуск версии
 
 Запустите `npm test` и `npm run test:package`: последняя команда упаковывает архив,