juce-webview-agent-bridge 0.3.1 → 0.4.0

package/CHANGELOG.md

@@ -0,0 +1,92 @@
+# Changelog
+
+Notable user-facing changes are recorded here. Release artifacts and complete
+commit comparisons are available from the linked GitHub Releases.
+
+## [Unreleased]
+
+## [0.4.0] - 2026-07-18
+
+### Added
+
+- Added a maintained project changelog and repository social preview.
+
+### Changed
+
+- Improved the npm package description and search keywords.
+- Raised the supported Node.js floor from the end-of-life Node 18 to Node 22;
+  CI now covers the supported Node 22 and 24 LTS lines.
+- Added npm version and license badges to the README.
+
+## [0.3.1] - 2026-07-18
+
+### Changed
+
+- Replaced long-lived npm publishing tokens with Trusted Publishing through
+  GitHub Actions OIDC.
+- Updated the official GitHub Actions to their Node 24-compatible releases.
+
+There are no package API changes in this release.
+
+## [0.3.0] - 2026-07-18
+
+### Added
+
+- Published the zero-runtime-dependency Node client as
+  `juce-webview-agent-bridge`.
+- Added strict TypeScript sources and declarations for the Playwright-shaped E2E
+  API, shared discovery helpers, and CLI.
+- Added package smoke tests covering clean installation, imports, declarations,
+  and the canonical `npx juce-webview-agent-bridge` command.
+- Added the root CMake entry point for JUCE consumers using `FetchContent`.
+- Added the manually triggered, fully tested GitHub and npm release workflow.
+
+## [0.2.2] - 2026-07-17
+
+### Fixed
+
+- Kept the native Windows screenshot backend compatible with the documented
+  C++17 minimum when recent MSVC libraries include C++/WinRT coroutine headers.
+
+## [0.2.1] - 2026-07-17
+
+### Added
+
+- Added native Windows 11 screenshots using Windows Graphics Capture and D3D11.
+- Added full-window and selector-based captures with DPI-aware cropping.
+- Advertised Windows screenshot support through the `hello` handshake.
+
+## [0.2.0] - 2026-07-16
+
+### Added
+
+- Added the macOS `layerdebug` op and `page.layerDebug()` for WebKit compositing
+  overlays.
+- Added the macOS `layertree` op and `page.layerTree()` for programmatic CALayer
+  inspection.
+- Added `parseLayerTree()` for extracting layer geometry from tree dumps.
+
+### Changed
+
+- Expanded CI to require the C++ suite on Windows and Linux.
+- Split detailed E2E and protocol documentation out of the README.
+
+## [0.1.0] - 2026-07-13
+
+### Added
+
+- Initial debug-only JUCE WebView bridge with loopback discovery and session
+  authentication.
+- JavaScript evaluation, DOM interaction, console/error/network capture, event
+  replay, and native macOS screenshots.
+- Zero-dependency CLI, Playwright-shaped E2E client, agent skill, and standalone
+  JavaScript and C++ test suites.
+
+[Unreleased]: https://github.com/mateusz28011/juce-webview-agent-bridge/compare/v0.4.0...HEAD
+[0.4.0]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.4.0
+[0.3.1]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.3.1
+[0.3.0]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.3.0
+[0.2.2]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.2.2
+[0.2.1]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.2.1
+[0.2.0]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.2.0
+[0.1.0]: https://github.com/mateusz28011/juce-webview-agent-bridge/releases/tag/v0.1.0

package/README.md

@@ -1,6 +1,10 @@
 # juce_webview_agent_bridge
 
+[![npm version](https://img.shields.io/npm/v/juce-webview-agent-bridge.svg)](https://www.npmjs.com/package/juce-webview-agent-bridge)
 [![tests](https://github.com/mateusz28011/juce-webview-agent-bridge/actions/workflows/tests.yml/badge.svg)](https://github.com/mateusz28011/juce-webview-agent-bridge/actions/workflows/tests.yml)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+![JUCE WebView plugin connected to an agent and E2E tests](https://raw.githubusercontent.com/mateusz28011/juce-webview-agent-bridge/main/docs/social-preview.png)
 
 A **debug-only** JUCE module that lets an external agent (or script) drive a live
 `juce::WebBrowserComponent` over a loopback TCP socket — a "mini-CDP" giving you a
@@ -70,7 +74,7 @@ inspection remains macOS-only. Linux real-app reports and fixes are very welcome
 ## Install
 
 **Requirements:** JUCE 8, C++17, a `juce::WebBrowserComponent`-based UI; the
-clients need Node ≥ 18 (zero runtime dependencies).
+clients need Node ≥ 22 (zero runtime dependencies).
 
 It's a standard JUCE module. Get the repo — as a submodule:
 
@@ -85,7 +89,7 @@ or with CMake `FetchContent` (after JUCE has been added, so
 include(FetchContent)
 FetchContent_Declare(juce_webview_agent_bridge
     GIT_REPOSITORY https://github.com/mateusz28011/juce-webview-agent-bridge.git
-    GIT_TAG        v0.3.1)
+    GIT_TAG        v0.4.0)
 FetchContent_MakeAvailable(juce_webview_agent_bridge)
 ```
 
@@ -201,7 +205,7 @@ Both suites live in `tests/` and run **independently of any host app**, so they
 keep working after this module is extracted into its own repo.
 
 ```bash
-# JS client — zero dependencies, Node >= 18
+# JS client — zero dependencies, Node >= 22
 npm test                     # or: node --test tests/*.test.mjs
 
 # Maintainer build — strict TypeScript source -> committed .mjs + .d.mts

package/package.json

@@ -1,7 +1,20 @@
 {
   "name": "juce-webview-agent-bridge",
-  "version": "0.3.1",
-  "description": "CLI + protocol client for the juce_webview_agent_bridge debug WebView bridge (eval/console/network/click/fill/screenshot over a loopback socket, no CDP).",
+  "version": "0.4.0",
+  "description": "Typed, zero-dependency E2E client and CLI for driving live JUCE WebViews over a debug-only loopback bridge, without CDP.",
+  "keywords": [
+    "juce",
+    "webview",
+    "wkwebview",
+    "webview2",
+    "e2e",
+    "testing",
+    "playwright",
+    "agent",
+    "automation",
+    "debugging",
+    "mcp-alternative"
+  ],
   "type": "module",
   "types": "./tools/e2e.d.mts",
   "exports": {
@@ -31,6 +44,7 @@
   "files": [
     "tools/",
     "README.md",
+    "CHANGELOG.md",
     "LICENSE"
   ],
   "license": "MIT",
@@ -39,7 +53,7 @@
     "url": "git+https://github.com/mateusz28011/juce-webview-agent-bridge.git"
   },
   "engines": {
-    "node": ">=18"
+    "node": ">=22"
   },
   "publishConfig": {
     "access": "public"

package/tools/shared.mjs

@@ -3,7 +3,7 @@
  * bridge discovery and NDJSON wire framing. Single source of truth — the two
  * clients used to carry private copies of this logic, and the copies drifted
  * (the fill focus fix landed in one and not the other), so it now lives here.
- * Still zero third-party dependencies: bare Node >= 18 built-ins only.
+ * Still zero third-party dependencies: bare Node >= 22 built-ins only.
  */
 import fs from 'node:fs';
 import os from 'node:os';