@metricinsights/pp-dev 0.19.0 → 1.0.0-beta.2

package/CHANGELOG.md

@@ -1,3 +1,201 @@
+# [1.0.0-beta.2](https://github.com/mi-examples/pp-dev/compare/v1.0.0-beta.1...v1.0.0-beta.2) (2026-07-07)
+
+
+### Features
+
+* **PP-3449:** add Dev Panel guide to README (position, auto-hide, hide/restore) ([54b8331](https://github.com/mi-examples/pp-dev/commit/54b833163bf65372f6ba55f5910cd7e3332261a9))
+
+# [1.0.0-beta.1](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.6...v1.0.0-beta.1) (2026-07-07)
+
+
+* feat(PP-3449)!: update dependencies and start the 1.0 release line ([abdad45](https://github.com/mi-examples/pp-dev/commit/abdad45b87e752d7468994f821841adc9e288e70))
+
+
+### Features
+
+* **PP-3449:** add Dev Panel guide to README (position, auto-hide, hide/restore) ([54b8331](https://github.com/mi-examples/pp-dev/commit/54b833163bf65372f6ba55f5910cd7e3332261a9))
+
+
+### BREAKING CHANGES
+
+* pp-dev moves to the 1.0 release line. Node.js >= 24
+is required (declared in engines) and the package is no longer
+published under the 0.x version scheme.
+
+# [1.0.0-beta.1](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.6...v1.0.0-beta.1) (2026-07-07)
+
+
+* feat(PP-3449)!: update dependencies and start the 1.0 release line ([abdad45](https://github.com/mi-examples/pp-dev/commit/abdad45b87e752d7468994f821841adc9e288e70))
+
+
+### BREAKING CHANGES
+
+* pp-dev moves to the 1.0 release line. Node.js >= 24
+is required (declared in engines) and the package is no longer
+published under the 0.x version scheme.
+
+# [0.20.0-beta.6](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.5...v0.20.0-beta.6) (2026-07-06)
+
+
+### Features
+
+* **PP-3449:** configurable dev panel position, hide and auto-hide modes ([315d6fc](https://github.com/mi-examples/pp-dev/commit/315d6fc4182c1128f77fe192a425e3f816970f6f))
+
+# [0.20.0-beta.5](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.4...v0.20.0-beta.5) (2026-07-06)
+
+
+### Bug Fixes
+
+* **PP-3449:** stop request inspector from swallowing proxied PUT/POST bodies ([610a993](https://github.com/mi-examples/pp-dev/commit/610a9933ac0a7ec19ee349ff7c6490b605a739ed))
+
+# [0.20.0-beta.4](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.3...v0.20.0-beta.4) (2026-07-02)
+
+
+### Bug Fixes
+
+* **PP-3449:** guard release.yml against non-tag workflow_dispatch runs ([a7f463f](https://github.com/mi-examples/pp-dev/commit/a7f463f7c0e75f3305b2dfab560ee9a6c315343d))
+
+# [0.20.0-beta.3](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.2...v0.20.0-beta.3) (2026-07-01)
+
+
+### Bug Fixes
+
+* **PP-3449:** address PR [#182](https://github.com/mi-examples/pp-dev/issues/182) code review comments ([010a182](https://github.com/mi-examples/pp-dev/commit/010a182136cf72eac0782e38750ea30f9f89f8f8))
+
+# [0.20.0-beta.2](https://github.com/mi-examples/pp-dev/compare/v0.20.0-beta.1...v0.20.0-beta.2) (2026-07-01)
+
+
+### Bug Fixes
+
+* **ui:** align dev panel with design ([0d020e3](https://github.com/mi-examples/pp-dev/commit/0d020e32c3e1608cafdcc0c7a5b368524867a785))
+
+# [0.20.0-beta.1](https://github.com/mi-examples/pp-dev/compare/v0.19.0...v0.20.0-beta.1) (2026-06-30)
+
+
+### Bug Fixes
+
+* address code review defects ([c734183](https://github.com/mi-examples/pp-dev/commit/c734183f2b4e7cd901e27502acff42d671d4dff4))
+* address review feedback defects ([85e2b80](https://github.com/mi-examples/pp-dev/commit/85e2b80ddc4cdeca9d97682315c4a0417cb34e5a))
+* **build:** run rollup-plugin-dts in child process to prevent Windows hang ([d9466b0](https://github.com/mi-examples/pp-dev/commit/d9466b0884f3e0eb5d01ef864e18ba32c6ff7899))
+* **ci:** restore fixture package install ([d0ea762](https://github.com/mi-examples/pp-dev/commit/d0ea762c6f9e6802cb3bca22d29f7193a0dcdf9c))
+* **e2e:** use taskkill /T /F on Windows to kill pp-dev process tree ([79ca61e](https://github.com/mi-examples/pp-dev/commit/79ca61e2f73144d9584bce762424853c154281e7))
+* **mock-mi:** fix broken regex and Windows-incompatible spawn in record.ts ([ad0b033](https://github.com/mi-examples/pp-dev/commit/ad0b0333976b38b362b74a47c8bad239d9b0e75a))
+* **mock-mi:** fix remaining TS errors in server.ts ([b538640](https://github.com/mi-examples/pp-dev/commit/b5386404e0fb16f8d5ba03073da507c8f679cb48))
+* **mock-mi:** fix TypeScript errors in mock-mi server and record scripts ([f64f835](https://github.com/mi-examples/pp-dev/commit/f64f8350e4353ac90f963feee99ff945c15572bf))
+* **mock-mi:** store binary responses as base64 in cassettes ([c6ee828](https://github.com/mi-examples/pp-dev/commit/c6ee82800dc4c621326f4032ea2f2ec606b0545b))
+* **security:** patch npm/node-gyp undici <=6.26.0 high-severity CVEs ([d4c8a10](https://github.com/mi-examples/pp-dev/commit/d4c8a10e704c75b6d1c1b7bcd8166d007b5270a2)), closes [hi#severity](https://github.com/hi/issues/severity) [hi#severity](https://github.com/hi/issues/severity)
+* **security:** pin undici to ^7.28.0 to fix CVEs without breaking jsdom ([d03bd5e](https://github.com/mi-examples/pp-dev/commit/d03bd5e744e18695a7c05c3e3e6b545e2a00b219))
+* **ui:** align panel bar with Figma spec (PP-3449) ([9ed1320](https://github.com/mi-examples/pp-dev/commit/9ed13200bb154753534a29b7f606b3fc663d3076))
+
+
+### Features
+
+* **inspector:** add Request Inspector with web UI and REST API ([e53fa90](https://github.com/mi-examples/pp-dev/commit/e53fa90639bdb6ed917772169ea2cb4f36de28a8))
+* **inspector:** print inspector URL banner to browser DevTools console ([9222397](https://github.com/mi-examples/pp-dev/commit/92223972ec5f649085a76afd22b2328aeafb0e97))
+* **mock-mi:** add PAT support and template API fetch to record-auto ([74c3142](https://github.com/mi-examples/pp-dev/commit/74c3142941456d9a8fdaad62fdb1ff956e6b147e))
+* **ui:** PP-3440 MI brand redesign — colors, Inter font, SVG type icons ([a0a30a5](https://github.com/mi-examples/pp-dev/commit/a0a30a5aafe07255cc74bb614d36f86a4ee64925)), closes [#075B7E](https://github.com/mi-examples/pp-dev/issues/075B7E) [#077E45](https://github.com/mi-examples/pp-dev/issues/077E45) [#AC2B2B](https://github.com/mi-examples/pp-dev/issues/AC2B2B) [#FFB000](https://github.com/mi-examples/pp-dev/issues/FFB000)
+* v1.0 grouped PPDevConfig schema, defineConfig helper, pp-dev migrate codemod ([222b4e5](https://github.com/mi-examples/pp-dev/commit/222b4e5949144295f07dd9fed87e131692323560))
+
+# [1.0.0](https://github.com/mi-examples/pp-dev/compare/v0.19.0-beta.2...v1.0.0) (2026-06-19)
+
+## ⚠ BREAKING CHANGES
+
+This release replaces the flat configuration API with a grouped schema. All existing `pp-dev.config.*` files must be updated — use `pp-dev migrate` to do it automatically.
+
+### Configuration schema
+
+The flat `VitePPDevOptions` object is replaced by `PPDevConfig` with five grouped sections:
+
+```ts
+// BEFORE (0.x)
+export default {
+  backendBaseURL: 'https://mi.company.com',
+  personalAccessToken: 'YOUR_TOKEN',
+  miHudLess: true,
+  v7Features: true,
+  appId: 937,
+  templateLess: false,
+};
+
+// AFTER (1.0)
+import { defineConfig } from '@metricinsights/pp-dev';
+
+export default defineConfig({
+  mi:    { url: 'https://mi.company.com', token: 'YOUR_TOKEN', mode: 'standalone', apiVersion: 7 },
+  app:   { id: 937, type: 'template' },
+});
+```
+
+| 0.x field | 1.0 field |
+|---|---|
+| `backendBaseURL` | `mi.url` |
+| `personalAccessToken` | `mi.token` |
+| `miHudLess: true` | `mi.mode: 'standalone'` |
+| `miHudLess: false` | `mi.mode: 'embedding'` |
+| `integrateMiTopBar: true` | `mi.mode: 'standalone'`, `mi.include: 'top-bar'` |
+| `integrateMiTopBar: { addSharedComponentsScripts: true }` | `mi.include: 'shared-components'` |
+| `v7Features: true` | `mi.apiVersion: 7` |
+| `v7Features: false` | `mi.apiVersion: 6` |
+| `appId` / `portalPageId` | `app.id` |
+| `templateName` | `app.name` (auto-resolved from `package.json#name` — usually omit) |
+| `templateLess: true` | `app.type: 'page'` |
+| `templateLess: false` | `app.type: 'template'` |
+| `enableProxyCache` | `proxy.cache` |
+| `proxyCacheTTL` | `proxy.cacheTtl` |
+| `disableSSLValidation: true` | `proxy.tls.allowSelfSigned: true` |
+| `distZip` | `build.zip` |
+| `versionPlugin` | `build.versionFile` |
+| `imageOptimizer` | `build.imageOptimisations` |
+| `outDir` | `build.outDir` |
+| `syncBackupsDir` | `sync.backupsDir` |
+
+### Removed
+
+- `pp-watch.config.*` / `.pp-watch.config.*` config files — use `pp-dev.config.*` instead
+- `PPWatchConfig` type
+- `VitePPDevOptions` type — use `PPDevConfig`
+- `normalizeVitePPDevConfig()` — internal, use `normalizePPDevConfig()`
+
+### Defaults
+
+| Field | Default |
+|---|---|
+| `mi.mode` | `'standalone'` |
+| `mi.apiVersion` | `7` |
+| `app.type` | `'template'` |
+| `app.name` | resolved from `package.json#name` |
+
+### Validation
+
+Startup validation now throws meaningful errors instead of silently ignoring bad config. Key rules:
+
+- `mi.include` requires `mi.mode: 'standalone'`
+- `mi.url` is required when `mi.mode: 'embedding'` or `app.type: 'template'`
+- `app.id` is required for templates and standalone pages
+
+### Migration
+
+Run the built-in codemod to upgrade your config automatically:
+
+```bash
+npx @metricinsights/pp-dev migrate
+# Preview changes first:
+npx @metricinsights/pp-dev migrate --dry-run
+# Force output format:
+npx @metricinsights/pp-dev migrate --format ts
+```
+
+The command detects flat 0.x configs and `pp-watch.config.*` files, migrates them to the new grouped format, and writes a `.bak` backup before overwriting.
+
+## Features
+
+* **config:** grouped `PPDevConfig` schema with `mi`, `app`, `proxy`, `build`, `sync` sections
+* **config:** `defineConfig()` helper for full TypeScript intellisense
+* **cli:** `pp-dev migrate` codemod — auto-migrates 0.x flat and `pp-watch` configs to 1.0 format, supports `--dry-run`, `--format ts|js|json`, `--output`, `--no-backup`
+* **ui:** redesigned dev panel — MI brand colors (`#075B7E`), Inter font, bordered buttons, updated toast and confirm modal styles
+
+---
+
 # [0.19.0-beta.2](https://github.com/mi-examples/pp-dev/compare/v0.19.0-beta.1...v0.19.0-beta.2) (2026-06-18)