@microsoft/windows-admin-center-sdk 6.0.0 → 6.1.0

package/3rdPartyDisclosure.html

@@ -8,8 +8,8 @@
 <body>
 <h1>THIRD-PARTY SOFTWARE NOTICES AND INFORMATION</h1>
 <p><strong>Do Not Translate or Localize</strong></p>
-<p>Note: While Microsoft is not the author of the files below, Microsoft is offering you a license subject to the terms of the Microsoft Software License Terms for <strong>@microsoft/windows-admin-center-sdk</strong> (version 6.0.0) (the &ldquo;Microsoft Program&rdquo;). Microsoft reserves all other rights. The notices below are provided for informational purposes only and are not the license terms under which Microsoft distributes these files.</p>
-<p class="meta">Generated automatically at build time &middot; 2026-08-14T12:12:36.802Z &middot; Section 1: 26 distributed component(s) &middot; Section 2: 14 peer.</p>
+<p>Note: While Microsoft is not the author of the files below, Microsoft is offering you a license subject to the terms of the Microsoft Software License Terms for <strong>@microsoft/windows-admin-center-sdk</strong> (version 6.1.0) (the &ldquo;Microsoft Program&rdquo;). Microsoft reserves all other rights. The notices below are provided for informational purposes only and are not the license terms under which Microsoft distributes these files.</p>
+<p class="meta">Generated automatically at build time &middot; 2026-11-04T04:15:11.412Z &middot; Section 1: 26 distributed component(s) &middot; Section 2: 11 peer.</p>
 <h2 class="section">Section 1 &mdash; Distributed Components</h2>
 <p>The third-party software listed here is <strong>distributed within</strong> the Microsoft Program &mdash; either compiled/inlined into its bundles (&ldquo;bundled/inlined&rdquo;) or installed as a runtime dependency (&ldquo;runtime dependency&rdquo;). This file is based on or incorporates material from the projects listed below (Third Party IP). The original copyright notice and the license under which Microsoft received such Third Party IP are set forth below. Such licenses and notices are provided for informational purposes only. Microsoft licenses the Third Party IP to you under the licensing terms for the Microsoft Program. Microsoft reserves all other rights not expressly granted under this agreement, whether by implication, estoppel or otherwise.</p>
 <ol>
@@ -21,7 +21,7 @@
 <li>@microsoft/signalr 8.0.7 (MIT)</li>
 <li>@typescript-eslint/eslint-plugin 8.62.0 (MIT)</li>
 <li>@typescript-eslint/parser 8.62.0 (MIT)</li>
-<li>ajv 6.12.6 (MIT)</li>
+<li>ajv 6.15.0 (MIT)</li>
 <li>del 8.0.1 (MIT)</li>
 <li>eslint 9.39.4 (MIT)</li>
 <li>eslint-plugin-import 2.32.0 (MIT)</li>
@@ -52,7 +52,7 @@
 <li><a href="https://github.com/dotnet/aspnetcore/tree/main/src/SignalR#readme">@microsoft/signalr</a> 8.0.7 <span class="meta">&mdash; included as runtime dependency &middot; author: Microsoft &middot; no bundled license text file</span></li>
 <li><a href="https://typescript-eslint.io/packages/eslint-plugin">@typescript-eslint/eslint-plugin</a> 8.62.0 <span class="meta">&mdash; included as runtime dependency &middot; Copyright (c) 2019 typescript-eslint and other contributors</span></li>
 <li><a href="https://typescript-eslint.io/packages/parser">@typescript-eslint/parser</a> 8.62.0 <span class="meta">&mdash; included as runtime dependency &middot; Copyright (c) 2019 typescript-eslint and other contributors</span></li>
-<li><a href="https://github.com/ajv-validator/ajv">ajv</a> 6.12.6 <span class="meta">&mdash; included as runtime dependency &middot; author: Evgeny Poberezkin &middot; Copyright (c) 2015-2017 Evgeny Poberezkin</span></li>
+<li><a href="https://github.com/ajv-validator/ajv">ajv</a> 6.15.0 <span class="meta">&mdash; included as runtime dependency &middot; author: Evgeny Poberezkin &middot; Copyright (c) 2015-2017 Evgeny Poberezkin</span></li>
 <li>del 8.0.1 <span class="meta">&mdash; included as runtime dependency &middot; author: Sindre Sorhus &lt;sindresorhus@gmail.com&gt;</span></li>
 <li><a href="https://eslint.org">eslint</a> 9.39.4 <span class="meta">&mdash; included as runtime dependency &middot; author: Nicholas C. Zakas &lt;nicholas+npm@nczconsulting.com&gt; &middot; Copyright OpenJS Foundation and other contributors, &lt;www.openjsf.org&gt;</span></li>
 <li><a href="https://github.com/import-js/eslint-plugin-import">eslint-plugin-import</a> 2.32.0 <span class="meta">&mdash; included as runtime dependency &middot; author: Ben Mosher &lt;me@benmosher.com&gt; &middot; Copyright (c) 2015 Ben Mosher</span></li>
@@ -408,19 +408,16 @@ software or this license, under any kind of legal claim.***</pre>
 <table>
 <thead><tr><th>Component</th><th>Version</th><th>License</th></tr></thead>
 <tbody>
-<tr><td>@angular/animations</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td>@angular/common</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td>@angular/compiler</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td>@angular/core</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td>@angular/forms</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td>@angular/platform-browser</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td>@angular/platform-browser-dynamic</td><td>20.3.25</td><td>MIT</td></tr>
-<tr><td><a href="https://github.com/angular/angular/tree/main/packages/router">@angular/router</a></td><td>20.3.25</td><td>MIT</td></tr>
+<tr><td>@angular/common</td><td>20.3.34</td><td>MIT</td></tr>
+<tr><td>@angular/compiler</td><td>20.3.34</td><td>MIT</td></tr>
+<tr><td>@angular/core</td><td>20.3.34</td><td>MIT</td></tr>
+<tr><td>@angular/forms</td><td>20.3.34</td><td>MIT</td></tr>
+<tr><td>@angular/platform-browser</td><td>20.3.34</td><td>MIT</td></tr>
+<tr><td><a href="https://github.com/angular/angular/tree/main/packages/router">@angular/router</a></td><td>20.3.34</td><td>MIT</td></tr>
 <tr><td><a href="https://www.chartjs.org">chart.js</a></td><td>2.9.4</td><td>MIT</td></tr>
 <tr><td><a href="https://reactjs.org/">react</a></td><td>^18</td><td>MIT</td></tr>
 <tr><td><a href="https://reactjs.org/">react-dom</a></td><td>^18</td><td>MIT</td></tr>
 <tr><td><a href="https://rxjs.dev">rxjs</a></td><td>~7.8.1</td><td>Apache-2.0</td></tr>
-<tr><td><a href="https://vite.dev">vite</a></td><td>^8.0.16</td><td>MIT</td></tr>
 <tr><td>zone.js</td><td>~0.15.1</td><td>MIT</td></tr>
 </tbody></table>
 </body>

package/README.md

@@ -7,82 +7,159 @@ scaffold and upgrade extensions.
 
 ## Requirements
 
-- **Node.js 24 or later** (the `wac` CLI and the Angular 20 toolchain require it).
+- **Node.js 24 or later** (the SDK and bundled `wac` CLI declare this minimum).
 - A package manager (`npm`, `pnpm`, or `yarn`).
 
 ## Install
 
 ```sh
-npm install @microsoft/windows-admin-center-sdk
+pnpm add @microsoft/windows-admin-center-sdk
 ```
 
-This makes the `wac` command available (via `npx wac …`, or on your `PATH` when installed
+This makes the `wac` command available (via `pnpm exec wac …`, or on your `PATH` when installed
 globally).
 
-## Create an extension
+## Create an Angular extension
 
 Scaffold a new extension project (Angular 20) in the current directory:
 
 ```sh
 # A single tool extension
-npx wac create --company <company-name> --name <tool-name>
+pnpm exec wac create --company <company-name> --name <tool-name>
 
 # A solution containing one or more tools
-npx wac create --company <company-name> --solution <solution-name> --tool <tool-name> --type <tool-type>
+pnpm exec wac create --company <company-name> --solution <solution-name> --tool <tool-name> --type <tool-type>
 ```
 
-| Flag | Description |
-| --- | --- |
-| `--company` | Your company or author name (required). |
-| `--name` | Tool name for a single-tool extension. |
-| `--solution` | Solution name (enables solution mode). |
-| `--tool` | Tool name within a solution. |
-| `--type` | Tool type within a solution. |
-| `--version` | SDK release ring to target: `latest` (default), `insider`, `next`, `experimental`, `release`. |
-| `--verbose` | Verbose logging. |
+| Flag         | Description                                                                                   |
+| ------------ | --------------------------------------------------------------------------------------------- |
+| `--company`  | Your company or author name (required).                                                       |
+| `--name`     | Tool name for a single-tool extension.                                                        |
+| `--solution` | Solution name (enables solution mode).                                                        |
+| `--tool`     | Tool name within a solution.                                                                  |
+| `--type`     | Tool type within a solution.                                                                  |
+| `--version`  | SDK release ring to target: `latest` (default), `insider`, `next`, `experimental`, `release`. |
+| `--verbose`  | Verbose logging.                                                                              |
 
-Then build and serve:
+Then install, build, and lint:
 
 ```sh
 cd <tool-name>
-npm install
-npm run build
-npm start -- --port=4200
+pnpm install
+pnpm run build
+pnpm run lint
 ```
 
+For unit tests, run `pnpm run test -- --watch=false`. The starter uses Puppeteer's
+Chrome browser. If dependency install scripts were skipped, install the test browser
+explicitly with `pnpm exec puppeteer browsers install chrome`.
+
+## Create a React extension
+
+```sh
+pnpm exec wac create-react --company <company-name> --name <tool-name>
+cd <tool-name>
+pnpm install
+pnpm run build
+```
+
+The React starter uses React 18 and Vite 8. The production build generates the
+PowerShell bindings and then runs TypeScript checking; either failure makes the
+build fail. After the first build, `pnpm run typecheck` checks the application
+without rebuilding its bundle. The starter does not include a React unit-test
+runner or lint configuration; add those to your extension's CI as needed.
+
+Import React runtime APIs from `@microsoft/windows-admin-center-sdk/react` and
+the Vite plugins from `@microsoft/windows-admin-center-sdk/react/vite`.
+
+## Serve and sideload locally
+
+Both starters use the following certificate layout, relative to the generated
+extension directory:
+
+```text
+certificate/
+  localhost.cert
+  localhost.key
+<tool-name>/
+  package.json
+```
+
+Create a development certificate valid for `localhost` with your organization's
+approved certificate tooling. Save its PEM certificate and PEM private key at the
+paths above and trust the certificate on the machine running the browser. Do not
+commit the private key.
+
+From the extension directory:
+
+```sh
+pnpm start
+```
+
+Open `https://localhost:4200/manifest.json` to confirm that the certificate is trusted
+and the extension is reachable. Angular requires the certificate files; React falls
+back to HTTP when they are absent, which is not suitable for sideloading into an
+HTTPS WAC page.
+
+Enable the developer experience on your local WAC installation. Allow the extension's
+exact HTTPS origin (including its port) in the gateway's developer CORS and frame
+settings. In the WAC browser page's developer console, register the extension:
+
+```js
+MsftSme.sideLoad('https://localhost:4200');
+```
+
+Open the extension from a supported server connection. For React, the sample Services
+page should load its service list through WAC. Use separate ports when testing both
+starters and allow each origin in the gateway settings.
+
 ## Upgrade an extension
 
 Upgrade an existing extension to the current Angular/toolchain baseline (Angular 15 → 20,
 Node 24), run from the extension's root:
 
 ```sh
-npx wac upgrade
+pnpm exec wac upgrade
 ```
 
-| Flag | Description |
-| --- | --- |
+| Flag          | Description                                                                                                                  |
+| ------------- | ---------------------------------------------------------------------------------------------------------------------------- |
 | `--stage <n>` | Run a single stage (`1`=configs, `2`=`ng update`, `3`=standalone, `4`=code fixups, `5`=eslint). Default `0` runs all stages. |
-| `--pipeline` | CI mode — skip interactive prompts. |
-| `--debug` | Verbose logging. |
+| `--pipeline`  | CI mode — skip interactive prompts.                                                                                          |
+| `--debug`     | Verbose logging.                                                                                                             |
 
 ## What's in the SDK
 
 Import the runtime libraries by subpath:
 
-| Import | Contents |
-| --- | --- |
-| `@microsoft/windows-admin-center-sdk/core` | Core runtime (RPC, host, notifications, data, manifest, …). |
-| `@microsoft/windows-admin-center-sdk/angular` | Angular components, directives, and services. |
-| `@microsoft/windows-admin-center-sdk/styles` | Shared CSS and fonts. |
-| `@microsoft/windows-admin-center-sdk/angular-devtools` | Build/lint/test tooling (gulp plugins, ESLint base, Prettier, webpack). |
-
-## What's new in 6.0.0
+| Import                                                 | Contents                                                                                                   |
+| ------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------- |
+| `@microsoft/windows-admin-center-sdk/core`             | Core runtime (RPC, host, notifications, data, manifest, …).                                                |
+| `@microsoft/windows-admin-center-sdk/angular`          | Angular components, directives, and services.                                                              |
+| `@microsoft/windows-admin-center-sdk/react`            | React SDK — `AppContextProvider`, `useAppContext` hook, and navigation services for React tool extensions. |
+| `@microsoft/windows-admin-center-sdk/styles`           | Shared CSS and fonts.                                                                                      |
+| `@microsoft/windows-admin-center-sdk/angular-devtools` | Build/lint/test tooling (gulp plugins, ESLint base, Prettier, webpack).                                    |
+
+## What's new in 6.1.0
+
+- **React scaffolding:** `wac create-react` creates a React 18/Vite 8 tool extension
+  with public SDK imports and a sample Services page.
+- **React build plugins:** the `react/vite` subpath provides PowerShell bindings,
+  localized manifest resources, and shared core strings.
+- **Scaffold validation:** Angular uses supported Zone.js test entry points and
+  declares its build dependencies; React production builds include TypeScript checks.
+- **Toolchain compatibility:** Angular starters keep `schema-utils` 4 at 4.7.0 via
+  pnpm/npm overrides to match Angular 20's Webpack version. React declares its own
+  Vite dependency rather than constraining the Angular dev server through an SDK peer.
+- **Node.js metadata:** the published SDK declares the same Node 24+ minimum as its CLI.
+
+## Upgrading from 5.x: changes introduced in 6.0.0
 
 6.0.0 modernizes the SDK toolchain. It contains **breaking changes** — review before upgrading.
 
 **Breaking changes**
 
-- **`wac` CLI now has two commands: `create` and `upgrade`.** The 5.x commands `eslint`
+- **`wac create` and `wac upgrade` replace the legacy CLI commands.** The 5.x commands `eslint`
   (tslint→eslint migration) and `angular15Upgrade` were removed. The Angular migration now
   lives under `wac upgrade` (Angular 15 → 20), and lint fixes run as a stage of `wac upgrade`.
 - **`wac upgrade` changed meaning.** In 5.x it audited/updated dependencies (`--audit`,