Skip to content

NativeHTMLKit PowerShell SDK v0.1.0

Pre-release
Pre-release

Choose a tag to compare

@nativehtmlkit nativehtmlkit released this 15 Nov 22:10
· 22 commits to main since this release

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

  1. 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.

  2. Extract it into a folder on your PSModulePath, so that NativeHTMLKit/NativeHTMLKit.psd1 sits directly in it:

    • PowerShell 7, current user: Linux ~/.local/share/powershell/Modules/, Windows Documents\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.

  3. Import-Module NativeHTMLKit (or simply use a command; the module auto-loads). The bundled host is verified against
    HOST-MANIFEST.json before each launch.

  4. Try it: New-NativeHTMLKitProject -Path ./MyApp, then pwsh -File ./MyApp/app.ps1 (or powershell.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

  • off diagnostics 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 it normal and 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.json on 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_BINARY overrides the bundled host without verification (development use).
  • Not tested: input methods (IME), and the long-running idle and bitmap-kill harness 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.