Skip to content

Commit 5f39e46

Browse files
committed
chore(release): 1.0.0
The package version is 1.0.0 and the changelog's Unreleased section is now 1.0.0; its "Upgrading from 0.0.7" notes stay. The Chrome extension keeps its own version. Decisions made for 1.0, which change what semver covers: - The `vite` peer range is `>=6`. The Vite plugin's tests pass on Vite 6.4, 7.3 and 8.3; Vite 5 cannot run the test suite, so it is no longer claimed. The upgrade notes say so. - The mobile entry points (overlay-manual, capacitor-hook, overlay-angular-native, overlay-nativescript) stay in this package through 1.x. - Any port on a loopback host passes the origin check; security.md now says so, and that the one-time code still applies. SECURITY.md describes 1.x support, and the agent tools page says the tools were renamed in 1.0.0.
1 parent a7cb0c6 commit 5f39e46

8 files changed

Lines changed: 13 additions & 8 deletions

File tree

‎SECURITY.md‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,8 @@
22

33
## Supported versions
44

5-
Pangular Inspector is in early development. Only the latest published release of
6-
`@pangular-inspector/devtools` is supported. There are no older release lines to backport a fix to.
5+
Security fixes go into the latest 1.x release of `@pangular-inspector/devtools`. Older 1.x
6+
releases and the 0.0.x releases get no backports: update to the latest 1.x release to get a fix.
77

88
## Reporting a vulnerability
99

‎apps/docs/src/content/agents/tools.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1022,7 +1022,7 @@ Use it for data that has no dedicated tool, such as hydration data and TransferS
10221022

10231023
## Renamed tools
10241024

1025-
Tools and arguments were renamed after 0.0.7 so that each name follows one pattern: an optional library prefix (`ngrx-`, `redux-`, `tanstack-`, `capacitor-`, `analog-`), then a verb that says whether the tool reads source (`scan`), reads the page (`list`, `inspect`, `explain`, `lint`) or writes (`run`, `set`, `record`). The old names are not accepted.
1025+
Tools and arguments were renamed in 1.0.0 so that each name follows one pattern: an optional library prefix (`ngrx-`, `redux-`, `tanstack-`, `capacitor-`, `analog-`), then a verb that says whether the tool reads source (`scan`), reads the page (`list`, `inspect`, `explain`, `lint`) or writes (`run`, `set`, `record`). The old names are not accepted.
10261026

10271027
| Before | Now |
10281028
| ---------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- |

‎apps/docs/src/content/contributing/publishing.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -96,6 +96,8 @@ This runs `pnpm --filter @pangular-inspector/devtools publish --access public`.
9696

9797
Each entry point exports only what these docs describe, and only that is covered by semver. The files in `packages/devtools/src/entries` choose those exports, and `public-api.test.ts` lists them, so a new export is a deliberate change. Code shared between the server, the overlay and the panel, such as most of `config.ts`, stays internal: the panel imports it as `@pangular-inspector/devtools/internal/config`, a workspace-only export that `publishConfig.exports` leaves out. Mark a declaration that has to be exported for the package's own modules with `@internal`, and the published types leave it out.
9898

99+
The mobile entry points (`overlay-manual`, `capacitor-hook`, `overlay-angular-native` and `overlay-nativescript`) stay in this package through 1.x. Moving one to its own package is a breaking change, so it waits for a major release.
100+
99101
## Supported versions
100102

101103
The Angular peer range has an upper bound, `>=12.2.0 <23.0.0`, because the overlay reads Angular's private debug APIs. Raise it in the release after the new major passes the [compatibility jobs](./development.md#angular-compatibility), and update the tested versions in [Installation](../getting-started/installation.md#tested-versions). `engines.node` is `>=22.12.0`, the first Node.js 22 that can `require()` the ES modules the Express hub loads.

‎apps/docs/src/content/getting-started/installation.md‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -84,7 +84,7 @@ declare module '@pangular-inspector/devtools/overlay';
8484

8585
### Tested versions
8686

87-
The peer range is `@angular/core` and `@angular/common` `>=12.2.0 <23.0.0`. The overlay reads Angular's private debug APIs, so each new major is tested before the range takes it in. CI tests these versions:
87+
The Vite plugin needs Vite 6 or later (`vite` `>=6`). The peer range is `@angular/core` and `@angular/common` `>=12.2.0 <23.0.0`. The overlay reads Angular's private debug APIs, so each new major is tested before the range takes it in. CI tests these versions:
8888

8989
| Angular | Node.js | What runs | When |
9090
| ----------------------- | ------- | ------------------------------------------------------------------------- | ------------------------------------- |

‎apps/docs/src/content/security.md‎

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,6 +45,8 @@ In detail, a request to the devtools must:
4545
- have an origin that is a loopback host, the [Pangular Inspector extension](#chrome-extension), an entry in `allowedOrigins`, or a host listed in Vite's `server.allowedHosts`, or
4646
- have no `Origin` header, and a `Sec-Fetch-Site` header of `same-origin`, `same-site` or `none`, or no `Sec-Fetch-Site` header at all.
4747

48+
A loopback origin means any port on a loopback host, so a page served by another dev server on this machine passes the origin check. It still needs the one-time code or a session token, which are on by default.
49+
4850
The `Host` check stops DNS rebinding: a website that points its own name at `127.0.0.1` still sends that name as the `Host`. Clients that send neither `Origin` nor `Sec-Fetch-Site`, such as curl or a native app, are not browsers, so they pass the last check. A request without a `Host` header passes the `Host` check, since browsers always send one. The emulator addresses are IP literals, which DNS rebinding cannot send, and the emulator forwards them to your machine's loopback interface, so only the emulator can send them from a loopback address.
4951

5052
Other requests get `403` with the message "Pangular Inspector only answers requests from this machine." A request from another machine also gets the fix: set `allowLan: true` and list its origin in `allowedOrigins`. WebSocket upgrades follow the same rules.

‎packages/devtools/CHANGELOG.md‎

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,14 +2,15 @@
22

33
All notable changes to `@pangular-inspector/devtools` are listed here. The format follows [Keep a Changelog](https://keepachangelog.com).
44

5-
## Unreleased
5+
## 1.0.0
66

77
Most setups need changes when they come from 0.0.7, so read **Upgrading from 0.0.7** first.
88

99
### Upgrading from 0.0.7
1010

1111
These changes can break a 0.0.7 setup without an error.
1212

13+
- **The Vite plugin needs Vite 6 or later.** The `vite` peer range is `>=6`, the versions its tests run against. Vite 5 apps can use the Express hub or the standalone CLI instead.
1314
- **The Vite plugin asks for the one-time code, and its MCP endpoint asks for a bearer token, by default.** In 0.0.7 the code was on only when a non-loopback host or origin was allowed. An MCP client set up against `http://localhost:5173/__devframes/__mcp` gets `401`. Send the token (see "Send a token" in the MCP server docs, or run `pangular mcp --print-config`), or pass `auth: false` on a machine only you use.
1415
- **The Express hub is off in production:** when `NODE_ENV` is `production`, or when the server is a production Angular build (`ngDevMode` is `false`). `nodeMiddleware` and `ssrMiddleware` then only call `next()`, and `/__devframes/` answers `404`. To keep the devtools on a staging server, pass `enabled: true` to `initPangularHub()`. Check `devtools.enabled` before the `app.use()` calls to skip them.
1516
- **The Express hub answers this machine only.** It refuses requests from other addresses and requests to a non-loopback `Host` with `403`. To reach it from a phone or another machine, pass `allowLan: true` and list the device's origin in `allowedOrigins`. `allowLan` needs the one-time code on.

‎packages/devtools/package.json‎

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "@pangular-inspector/devtools",
3-
"version": "0.0.7",
3+
"version": "1.0.0",
44
"description": "Pangular Inspector, the unified Angular devtools. Inspect components, signals, DI, and routes. Runs standalone, embedded, or over MCP.",
55
"license": "MIT",
66
"repository": {
@@ -178,7 +178,7 @@
178178
"@angular/common": ">=12.2.0 <23.0.0",
179179
"@angular/core": ">=12.2.0 <23.0.0",
180180
"rxjs": ">=7",
181-
"vite": ">=5"
181+
"vite": ">=6"
182182
},
183183
"peerDependenciesMeta": {
184184
"@nativescript/core": {

‎pnpm-lock.yaml‎

Lines changed: 1 addition & 1 deletion
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

0 commit comments

Comments
 (0)