Repository navigation
Releases
NativeHTMLKit PowerShell SDK v0.1.2
NativeHTMLKit PowerShell SDK 0.1.2
Documentation and PowerShell Gallery description release. The cmdlet API and behaviour are unchanged from 0.1.1. The module bundles the same NativeHTMLKit Core 1.0.3 hosts as 0.1.1 (public stable wire protocol v1):
linux-x64 1cd4e9de701f3ef8d8b870b678765243f2365d69d7352c0543f171ff249c999f, win-x64 15967208d2e20d208d69b97bba6f397056e28c57add126909a8734361ae8f8c8.
Source: commit e11c77922b5413db4fe4d55aeca34e42844052e3 (SDK source-tree hash 7f5a8f6fc5bcd440b0b04e3609c84752db4e953af5ff44d525852e34ba92ab00). Package NativeHTMLKit-0.1.2-linux-x64+win-x64.zip SHA-256 602ac4bc4e393f5ddaaa4f7d442c9c1b9b4e7fb5a9c974a8f110967e61e8a52e (development_package: false).
Changes since 0.1.1
- New module-manifest Description and ReleaseNotes (what the Gallery shows), revised README, API/architecture/build docs and bundled agent skill.
Install
Install-Module NativeHTMLKit -Scope CurrentUser # or: Install-PSResource NativeHTMLKitPowerShell 7.2+ on Linux and Windows, Windows PowerShell 5.1 on Windows.
Qualification of this exact package (local lab, not CI)
| Runtime / session | Gates | G6 real desktop |
|---|---|---|
| PS 7.7.0, Debian 13 workstation (headless) | 12 PASS, 1 BLOCKED (G6: not a desktop) | — |
| PS 7.7.0, linuxDEV KDE Plasma 6.6 Wayland | 14/14 PASS | 29/29, clean teardown |
| PS 7.7.0, winDEV interactive RDP desktop | 14/14 PASS | 29/29, clean teardown |
| Windows PowerShell 5.1.20348, same desktop | 14/14 PASS | 29/29, clean teardown |
All Pester suites pass on every runtime. Gates include installed-package smoke tests (headless and GUI) and a Gallery-style install from a local repository (Install-Module on 5.1).
NativeHTMLKit PowerShell SDK v0.1.1
NativeHTMLKit PowerShell SDK 0.1.1
NativeHTMLKit is a PowerShell module that turns ordinary PowerShell scripts into native desktop apps built from local HTML
and CSS. Windows, input, layout, rendering and accessibility come from the bundled NativeHTMLKit Core host (Rust); the module
speaks the Core wire protocol v1 to it. No browser, JavaScript runtime, web server, Python or Rust toolchain is needed.
Canonical commands are Verb-NativeHTMLKitNoun (88 functions), each with a Verb-NHKNoun alias.
This is a full release. It bundles NativeHTMLKit Core 1.0.3, with which Core wire protocol v1 became the public-stable wire
contract (1.0), and it requires Core 1.0.3 behaviour. It is the first version on the PowerShell Gallery.
Install
Install-PSResource NativeHTMLKit -Version 0.1.1 # PowerShell 7.4+ (PSResourceGet)
Install-Module NativeHTMLKit -RequiredVersion 0.1.1 # Windows PowerShell 5.1 / PowerShellGet
Or from the ZIP below:
- Check the download:
sha256sum NativeHTMLKit-0.1.1-linux-x64+win-x64.zip(Linux) or
Get-FileHash NativeHTMLKit-0.1.1-linux-x64+win-x64.zip(Windows) must print the SHA-256 below. - Extract it into a folder on your
PSModulePath, so thatNativeHTMLKit/NativeHTMLKit.psd1sits directly in it
(current user: Linux PS 7~/.local/share/powershell/Modules/, Windows PS 7Documents\PowerShell\Modules\,
Windows PowerShell 5.1Documents\WindowsPowerShell\Modules\). On Windows,Unblock-Filea browser download first. Import-Module NativeHTMLKit(or just use a command; the module auto-loads), then try
New-NativeHTMLKitProject -Path ./MyAppandpwsh -File ./MyApp/app.ps1(orpowershell.exe -File .\MyApp\app.ps1).
Either way the bundled host is checked against HOST-MANIFEST.json before each launch. A package manager may drop the Linux
host's executable bit; the module restores it.
Artifact
| File | SHA-256 |
|---|---|
NativeHTMLKit-0.1.1-linux-x64+win-x64.zip |
e7fac0d0ef230b32eb0ea544fbbc17fcbe32e424a49682a08374f33219fb40ce |
The ZIP is byte-reproducible from source commit 215f75a0b49d1e946b094e45e72596774255d19d (SDK source tree hash
a98ba47152089aea6a6a6059e6897be173fc1c2bc07b8ef24b6f813799487636) with scripts/package-local.py and the Core release
directories below. It contains the module, both Core hosts, the Core licences and notices, HOST-MANIFEST.json
(development_package: false, host hashes and each host's embedded source identity) and SHA256SUMS for every packaged file.
Bundled Core hosts: NativeHTMLKit Core 1.0.3, source commit d73dec36adbe1b1380f982388d13655750e607df, source tree
523c7a42e458e96e6943f8641df6cf3a32a85152, clean. Both hosts report that identity in nativehtmlkit-host --version --verbose,
and the packager checked it against the Core release manifests.
| Runtime | File | SHA-256 |
|---|---|---|
| linux-x64 | runtimes/linux-x64/nativehtmlkit-host |
1cd4e9de701f3ef8d8b870b678765243f2365d69d7352c0543f171ff249c999f |
| win-x64 | runtimes/win-x64/nativehtmlkit-host.exe |
15967208d2e20d208d69b97bba6f397056e28c57add126909a8734361ae8f8c8 |
Changes since 0.1.0 (prerelease)
- Bundles Core 1.0.3 (was 1.0.2). Protocol v1 is now stable (1.0).
- Diagnostics level
offis passed to the host unchanged. Core 1.0.3 relays the script's own output and fatal error at every
level (NHK-CROSS-0007), so the 0.1.0 interimoff→normalmapping andNATIVEHTMLKIT_SDK_DIAGNOSTICSare gone. - Live bitmaps work on Linux with the Core 1.0.3 host's shared lock on transport files (NHK-CROSS-0008, found by this SDK).
The transport path the host returns is exposed as$bitmap.Mapping.TransportPath. On Windows the files now live in
%TEMP%\nativehtmlkit-bitmaps\. Get-NativeHTMLKitDiagnosticReportincludes the host'sdropped_notificationscounter.- Core 1.0.3 window behaviour applies: a new window is first shown when its first document has loaded, or after at most
750 ms (on Windowsobserved.visibleis false until then), and new windows are clamped to the work area. In the
accessibility tree a drop-down<select>is now a combo box holding a list of list items (NHK-CROSS-0009). - Packaging records and cross-checks each host's source identity, and refuses hosts built from different Core sources.
- PowerShell Gallery: manifest metadata meets the Gallery rules, and installing by module name is part of qualification.
Supported platforms and editions
- PowerShell 7.2+ on Linux x64 (qualified on 7.7.0; installed-package smoke also on 7.4.2) and Windows x64 (qualified on 7.7.0).
- Windows PowerShell 5.1 on Windows x64 (qualified on 5.1.20348, Windows Server 2022).
- Desktops: KDE Plasma 6.6 (native Wayland) and the interactive Windows desktop. x64 only.
What was qualified
All runs used this ZIP and the pinned hosts, from the clean commit above, with one command per platform/edition
(scripts/qualify.ps1). There are 55 results, all with the same source tree hash. Evidence is in the Project workspace under
verification/2026-11-16-full-release/powershell/release/.
| Runtime / session | Gates | Pester tests | Real desktop GUI (real input) | Installed package | Gallery-style install |
|---|---|---|---|---|---|
| PowerShell 7.7.0, Debian 13 workstation (headless) | 12 PASS, 1 BLOCKED (no desktop, by design) | 158 passed, 0 failed, 0 skipped | — | PASS; Docker clean room (Ubuntu 22.04, PowerShell 7.4.2, no network, no Rust/Python) 12/12 | PASS |
| PowerShell 7.7.0, KDE Plasma 6.6 Wayland (linuxDEV) | 14/14 PASS | 158/158 | 29/29 checks, clean teardown | PASS headless and GUI | PASS |
| PowerShell 7.7.0, Windows interactive desktop (winDEV) | 14/14 PASS | 158/158 | 29/29 checks, clean teardown | PASS headless and GUI | PASS |
| Windows PowerShell 5.1.20348, same desktop | 14/14 PASS | 158/158 | 29/29 checks, clean teardown | PASS headless and GUI | PASS (PowerShellGet Install-Module) |
Pester skips the 2 tests that only apply to the other OS (Linux-only on Windows, Windows-only on Linux); a skipped
real-host test would count as a failure.
- Gallery-style install: PowerShell 7 publishes the module from this ZIP to a local repository with
Publish-PSResourceand checks the.nupkgcontents. It then installs the module by name withSave-PSResourceand runs
the installed-package smoke. Windows PowerShell 5.1 installs from that repository with PowerShellGetInstall-Module, runs
the same smoke, and uninstalls. - GUI checks: they use real OS input (uinput on Wayland, SendInput on Windows) and cover:
- the window appears;
- mouse (left/right/middle), keyboard into inputs, form submit, ordered callbacks under input;
- native save/open dialogs and cancellation;
- minimize/maximize, frameless drag and eight resize edges, HTML window-chrome buttons;
- live bitmaps (geometry, 1000+ frames, bounded memory, transport cleanup);
- the accessibility tree (AT-SPI / UI Automation);
- clipboard exchange with another app;
- close veto then allow, and a clean exit with no leftover processes.
- Pester: it covers the transport, fault injection, background tasks, diagnostics privacy and launch-credential
scrubbing. New in 0.1.1 are real-host tests for out-of-order reply correlation and for opening the bitmap transport from
.NET while the host holds it.
Known limitations
- Hang detection: a request that gets no reply raises
NativeHTMLKit.RpcTimeoutExceptionafter its deadline (default
15 s; native dialogs wait indefinitely). Its outcome is unknown. The SDK has no separate
liveness watchdog for a host that stops answering. - Stopped host (Linux): if the launcher dies while the whole host process is stopped (
SIGSTOP, a debugger halt), the
host, its backend and its systemd unit stay until the host is continued or killed. Core's launcher watchdog covers a
blocked event loop only (Core protocol §9, NHK-CROSS-0001 residual). The PowerShell SDK does not kill the host itself in
that case. - Host integrity check: the bundled host is re-hashed against
HOST-MANIFEST.jsonon every launch, but the file could
still be replaced between the hash and the moment the OS executes it. This checks the installed copy; it doesn't prove
who built it.NATIVEHTMLKIT_HOST_BINARYoverrides the bundled host without verification (development use). - No cross-SDK parity suite: behaviour is qualified per SDK against the same Core host, not by one shared conformance
suite run against the Python, PowerShell and CLI clients. - List commands return one array object (
Get-NativeHTMLKitWindowList,Get-NativeHTMLKitStylesheets,
Get-NativeHTMLKitSelectOptions): assign the result ($list = ...; $list.Count); wrapping the call in@()or piping it
gives a single item. - Not qualified: mixed per-monitor DPI scaling on Windows, real system suspend/resume, input methods (IME), and the
long-runningidleandbitmap-killharness modes. - x64 only (Linux x64, Windows x64).
NativeHTMLKit PowerShell SDK v0.1.0
NativeHTMLKit PowerShell SDK 0.1.0 (prerelease)
NativeHTMLKit is a PowerShell module that turns ordinary PowerShell scripts into native desktop apps built from local HTML
and CSS. Windows, input, layout, rendering and accessibility come from the bundled NativeHTMLKit Core host (Rust); the module
speaks the Core wire protocol v1 to it. No browser, JavaScript runtime, web server, Python or Rust toolchain is needed.
Canonical commands are Verb-NativeHTMLKitNoun (88 functions), each with a Verb-NHKNoun alias.
This is the first standalone release of the SDK. It is a prerelease: the Core wire protocol v1 is still 1.0-rc.
Artifact
| File | SHA-256 |
|---|---|
NativeHTMLKit-0.1.0-linux-x64+win-x64.zip |
8e1fe37f589e4f89f3b4381b2cd2f7fdd1eefae8ede91cc84a936b4dadcf397b |
The ZIP is byte-reproducible from source commit 5734a3a (SDK source tree hash
1c36541cc1825caf4cfd3dbcbafc2d860a1187840ed8deeb968357f13a169639) with scripts/package-local.py and the Core release
directories below. It contains the module, both Core hosts, the Core licences and notices (licenses/core/<rid>/),
HOST-MANIFEST.json and SHA256SUMS for every packaged file.
Bundled Core hosts (NativeHTMLKit Core 1.0.2, source commit 8a09875cff58aa16b60573ffca24de4d611d60b3, clean tree):
| Runtime | File | SHA-256 |
|---|---|---|
| linux-x64 | runtimes/linux-x64/nativehtmlkit-host |
702adafcbfe3c969cb12d0de5d37546727ee13b147c8fc866c7afa18aa741d2a |
| win-x64 | runtimes/win-x64/nativehtmlkit-host.exe |
64d4502f27782bd17329ab6d560fc27b4e3d404b719ddd9bafc507d46d8638f4 |
Supported platforms and editions
- PowerShell 7.2+ on Linux x64 (qualified on 7.7.0; installed-package smoke also on 7.4.2) and Windows x64 (qualified on 7.7.0).
- Windows PowerShell 5.1 on Windows x64 (qualified on 5.1.20348, Windows Server 2022).
- Desktops: KDE Plasma (native Wayland) and the interactive Windows desktop.
Install from the ZIP
-
Check the download:
sha256sum NativeHTMLKit-0.1.0-linux-x64+win-x64.zip(Linux) or
Get-FileHash NativeHTMLKit-0.1.0-linux-x64+win-x64.zip(Windows) must print the SHA-256 above. -
Extract it into a folder on your
PSModulePath, so thatNativeHTMLKit/NativeHTMLKit.psd1sits directly in it:- PowerShell 7, current user: Linux
~/.local/share/powershell/Modules/, WindowsDocuments\PowerShell\Modules\ - Windows PowerShell 5.1, current user:
Documents\WindowsPowerShell\Modules\
Expand-Archive ./NativeHTMLKit-0.1.0-linux-x64+win-x64.zip -DestinationPath "$HOME/.local/share/powershell/Modules" # Linux, PS 7
On Windows, unblock the ZIP first if it came from a browser (
Unblock-File), then extract. - PowerShell 7, current user: Linux
-
Import-Module NativeHTMLKit(or simply use a command; the module auto-loads). The bundled host is verified against
HOST-MANIFEST.jsonbefore each launch. -
Try it:
New-NativeHTMLKitProject -Path ./MyApp, thenpwsh -File ./MyApp/app.ps1(orpowershell.exe -File .\MyApp\app.ps1).
What was qualified
All on the package above and the pinned hosts, with one command per platform/edition (scripts/qualify.ps1); evidence in
the Project workspace verification/2026-11-15-sdk/powershell/release/ (51 results, one source tree hash):
| Runtime / session | Gates | Pester tests | Real desktop GUI (real input) | Installed-package smoke |
|---|---|---|---|---|
| PowerShell 7.7.0, Linux workstation (headless) | 11 PASS, 1 BLOCKED (no desktop, by design) | 154 passed, 0 failed, 0 skipped | — | PASS; Docker clean room (Ubuntu 22.04, PowerShell 7.4.2, no network, no Rust/Python) 10/10 |
| PowerShell 7.7.0, KDE Plasma 6.6 Wayland | 13/13 PASS | 154/154 | 29/29 checks | PASS headless and GUI |
| PowerShell 7.7.0, Windows interactive desktop | 13/13 PASS | 154/154 | 29/29 checks | PASS headless and GUI |
| Windows PowerShell 5.1, Windows interactive desktop | 13/13 PASS | 154/154 | 29/29 checks | PASS headless and GUI |
The GUI checks use real OS input (uinput on Wayland, SendInput on Windows) and assert behaviour: window appears, mouse
(left/right/middle), keyboard into inputs, form submit, ordered callbacks under input, native save/open dialogs and
cancellation, minimize/maximize, frameless drag and eight resize edges, HTML window-chrome buttons, accessibility tree
(AT-SPI / UI Automation), clipboard exchange with another app, close veto then allow, clean exit with no leftover processes.
Pester covers the transport, fault injection (malformed/oversized/truncated frames, host death, lost replies), background
tasks, diagnostics privacy (sentinel secrets never reach a support bundle), launch-credential scrubbing, and the findings of
an independent adversarial review (all fixed; 19 of 20 test mutants killed, the survivor is an equivalent mutant).
Known limitations
offdiagnostics level (Core NHK-CROSS-0007): the Core host would also drop the script's own output and fatal error at
NATIVEHTMLKIT_DIAGNOSTICS=off. Interim behaviour: when the SDK starts the host it gives itnormaland keeps only the SDK's
own records off (NATIVEHTMLKIT_SDK_DIAGNOSTICS=off), so the host still writes its normal lifecycle records. Will be removed
once Core relays application output independently of the level.- List commands return one array object (
Get-NativeHTMLKitWindowList,Get-NativeHTMLKitStylesheets,
Get-NativeHTMLKitSelectOptions), as the legacy module did: assign the result ($list = ...; $list.Count); wrapping the call
in@()or piping it yields a single item. - Host integrity check: the bundled host is re-hashed against
HOST-MANIFEST.jsonon every launch, but the file could still be
replaced between the hash and the moment the operating system executes it. This is an integrity check of the installed copy,
not proof of who built it.NATIVEHTMLKIT_HOST_BINARYoverrides the bundled host without verification (development use). - Not tested: input methods (IME), and the long-running
idleandbitmap-killharness modes. - Protocol: Core wire protocol v1 is
1.0-rc; its public stability guarantee is still withheld by Core. - Distribution: not published on the PowerShell Gallery; install from this ZIP.
- x64 only.