@gjsify/gtk-runtime-win32-arm64 0.0.0-stage → 0.64.9

package/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 gjsify contributors
+
+This license covers the SOURCE of this package (index.js, index.d.ts) and the
+build script in the gjsify repository that assembles the bundle. It does NOT
+cover the third-party GTK / GObject-Introspection binaries under `gtk/`: those
+keep the terms of their own projects, reproduced in
+`gtk/THIRD-PARTY-NOTICES.md` and `gtk/licenses/` inside the published tarball.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,59 @@
-# Temporary Holding Version
-
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+# @gjsify/gtk-runtime-win32-arm64
+
+Batteries-included GTK / GObject-Introspection runtime bundle for **Windows arm64**.
+It lets [`@gjsify/node-gi`](../node-gi) load `gi://` namespaces (GLib · GObject ·
+Gio · cairo · Pango · Graphene · Gdk) with **no gvsbuild / system GTK** installed on
+the host — the arm64 sibling of [`@gjsify/gtk-runtime-win32-x64`](../gtk-runtime-win32-x64).
+
+Platform-gated (`os: ["win32"]`, `cpu: ["arm64"]`), tier 3 (experimental). On any
+other platform npm skips it and `@gjsify/node-gi` falls back to a system/gvsbuild
+GTK. The heavy `gtk/` payload is **not committed** — it is built on a
+`windows-11-arm` CI runner and shipped via the package tarball / staged into
+node-gi's `prebuilds/win32-arm64/gtk/`.
+
+## Where the arm64 prefix comes from — there is no upstream ZIP
+
+`wingtk/gvsbuild` hardcodes `self.platform = "x64"` and publishes only an x64
+release ZIP, so unlike the x64 sibling there is nothing to download here. The
+prefix is **built from source** in CI by our MSVC fork, `gjsify/gvsbuild`
+(`.github/actions/gvsbuild-arm64-prefix`, pinned by commit SHA and cached), the
+whole route recorded in
+[ADR 0089](../../../docs/adr/0089-win32-arm64-gtk-is-built-from-source-by-our-msvc-gvsbuild-fork.md).
+MSVC end to end, never MSYS2/`CLANGARM64`, so the x64 addon recipe
+(`binding.gyp`, `win-gi-gyp-flags.mjs`) and this package's builder transfer
+unchanged — only the `--prefix` path and the toolset (`vcvarsarm64`) differ.
+Exit: when upstream gvsbuild ships an arm64 target, this switches to the
+version pin and the fork is retired.
+
+**Still out of scope on arm64 today** (ADR 0089, `status/open-todos/windows.md`
+§ win32-arm64): the two-pass gst-plugins-good build for `gstsoup.dll` /
+`souphttpsrc` (an arm64 bundle therefore has no http(s) media source yet), plus
+webgl (`gwebgl.dll`), gamepad and WebView2 — none of those are built against
+the arm64 prefix yet.
+
+## The builder is shared with the x64 sibling
+
+`packages/node-gi/scripts/build-gtk-runtime-win32.mjs` serves both win32
+targets — the DLL closure walk (`dumpbin`), the typelib set, the `--windowing`
+superset and the license corpus are arch-agnostic; the only arch-dependent
+inputs are `--prefix` (the gvsbuild zip extraction on x64, the fork-built
+prefix at `C:\gtk-build\gtk\ARM64\release` on arm64) and the MSVC toolset
+(`vcvarsarm64.bat`). See that script and
+[`@gjsify/gtk-runtime-win32-x64`'s README](../gtk-runtime-win32-x64/README.md)
+for the full build/layout/loader documentation — it applies here unchanged,
+down to the DLL layout (`gtk/bin`, not `gtk/lib`), the `--windowing` superset,
+the typelib-API floor and the license-coverage gate. Built on the Windows-on-ARM
+runner:
+
+```
+node ..\scripts\build-gtk-runtime-win32.mjs --windowing --prefix C:\gtk-build\gtk\ARM64\release --out gtk ^
+  --addon <node_gi.node built for arm64>
+```
+
+## How node-gi finds + activates it
+
+Identical to the x64 sibling: node-gi's loader (`gtk-runtime.js`) resolves
+`@gjsify/gtk-runtime-win32-arm64` by name (and the usual override/dev-sibling
+candidates), prepends `gtk/bin` to `PATH` before the addon loads, and prepends
+`gtk/girepository-1.0` to the GIRepository search path — no relocation, no
+re-exec, the same mechanism the x64 README documents in full.

package/gtk/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,178 @@
+# Third-party notices
+
+This directory is a self-contained GTK / GObject-Introspection runtime for **win32-arm64**, assembled from third-party free-software libraries. The npm package around it (`@gjsify/gtk-runtime-*`) is MIT-licensed; **the binaries below are not** — they keep the terms of their own projects, reproduced here.
+
+- Assembled by: `packages/node-gi/scripts/build-gtk-runtime-win32.mjs`
+- Build prefix (source of every binary): `C:\gtk-build\gtk\ARM64\release`
+- Variant: `--windowing` (full runtime incl. GSettings schemas + icon themes)
+- License texts recovered from that prefix: `licenses/`
+
+## Modifications to the binaries
+
+None. The libraries are byte-identical copies of the build prefix; the bundle is made portable
+by search path alone (the loader prepends this directory before the first `LoadLibrary`).
+
+## Components
+
+Per-binary attribution is **not recoverable** from this build prefix: it is a single flat build
+tree, so the license corpus it ships is reproduced in full below and applies to the bundled
+binaries collectively. Listing every project the prefix documents is deliberate over-inclusion.
+
+What is NOT left to over-inclusion is coverage: the build fails unless every bundled binary
+belongs to a declared project whose terms are in this payload, so a shipped library with no
+license text cannot leave the builder.
+
+| Component | Version | License (as declared by the build prefix) | Texts included |
+|---|---|---|---|
+| adwaita-fonts | — | OFL-1.1 | OFL.txt |
+| adwaita-icon-theme | — | (see included text) | COPYING_CCBYSA3, COPYING, COPYING_LGPL |
+| cairo | — | (see included text) | COPYING |
+| directx-headers | — | (see included text) | LICENSE |
+| expat | — | (see included text) | AUTHORS, COPYING |
+| fontconfig | — | (see included text) | COPYING |
+| freetype \* | — | (see included text) | LICENSE-FTL.TXT, LICENSE-GPLv2.TXT, LICENSE.TXT |
+| fribidi | — | (see included text) | COPYING |
+| gdk-pixbuf | — | (see included text) | COPYING |
+| gettext | — | (see included text) | COPYING |
+| glib \* | — | (see included text) | COPYING |
+| glib-networking | — | (see included text) | COPYING, LICENSE_EXCEPTION |
+| gobject-introspection \* | — | (see included text) | COPYING, COPYING.LGPL |
+| gperf | — | (see included text) | COPYING |
+| graphene \* | — | (see included text) | LICENSE.txt |
+| gsettings-desktop-schemas | — | (see included text) | COPYING |
+| gst-plugins-bad | — | (see included text) | COPYING |
+| gst-plugins-base | — | (see included text) | COPYING |
+| gst-plugins-good | — | (see included text) | COPYING |
+| gstreamer | — | (see included text) | COPYING |
+| gtk4 | — | (see included text) | COPYING |
+| gtksourceview5 | — | (see included text) | COPYING |
+| harfbuzz | — | (see included text) | COPYING |
+| icu | — | (see included text) | LICENSE |
+| libadwaita | — | (see included text) | COPYING |
+| libepoxy | — | (see included text) | COPYING |
+| libffi | — | (see included text) | LICENSE |
+| libjpeg-turbo | — | (see included text) | LICENSE.md |
+| libpng | — | (see included text) | LICENSE |
+| libpsl | — | (see included text) | LICENSE |
+| librsvg | — | (see included text) | COPYING.LIB |
+| libsoup3 | — | (see included text) | COPYING |
+| libtiff \* | — | (see included text) | LICENSE.md |
+| libvorbis | — | (see included text) | COPYING |
+| libxml2 \* | — | (see included text) | COPYING |
+| libyuv | — | (see included text) | LICENSE |
+| mit-kerberos | — | (see included text) | NOTICE |
+| nghttp2 | — | (see included text) | COPYING |
+| ogg | — | (see included text) | COPYING |
+| openssl \* | — | (see included text) | LICENSE.txt |
+| opus | — | (see included text) | COPYING |
+| orc | — | (see included text) | COPYING |
+| pango | — | (see included text) | COPYING |
+| pcre2 | — | (see included text) | COPYING |
+| pixman | — | (see included text) | COPYING |
+| pkgconf | — | (see included text) | AUTHORS, COPYING |
+| sqlite \* | — | (see included text) | LICENSE.md |
+| win-iconv | — | (see included text) | COPYING |
+| zlib \* | — | (see included text) | LICENSE |
+
+\* The build prefix documents no terms for 9 project(s) it nevertheless builds binaries from, so their texts are reproduced from the upstream release the prefix pins. The file and the version it was taken from are recorded next to the builder — `freetype`, `glib`, `gobject-introspection`, `graphene`, `libtiff`, `libxml2`, `openssl`, `sqlite`, `zlib`.
+
+49 component(s) ship their license text in `licenses/`; 0 declare a license without shipping its text in the build prefix — for those the declared identifier above is the authoritative statement of terms, and the corresponding text is obtainable from the project and from spdx.org/licenses.
+
+## Bundled binaries
+
+- `adwaita-1-0.dll`
+- `cairo-2.dll`
+- `cairo-gobject-2.dll`
+- `cairo-script-interpreter-2.dll`
+- `comerr64.dll`
+- `epoxy-0.dll`
+- `ffi-8.dll`
+- `fontconfig-1.dll`
+- `freetype-6.dll`
+- `fribidi-0.dll`
+- `gdk_pixbuf-2.0-0.dll`
+- `gio-2.0-0.dll`
+- `giognomeproxy.dll`
+- `gioopenssl.dll`
+- `girepository-1.0-1.dll`
+- `girepository-2.0-0.dll`
+- `glib-2.0-0.dll`
+- `gmodule-2.0-0.dll`
+- `gobject-2.0-0.dll`
+- `graphene-1.0-0.dll`
+- `gspawn-win64-helper-console.exe`
+- `gspawn-win64-helper.exe`
+- `gssapi64.dll`
+- `gst-plugin-scanner.exe`
+- `gstalaw.dll`
+- `gstapp-1.0-0.dll`
+- `gstapp.dll`
+- `gstaudio-1.0-0.dll`
+- `gstaudioconvert.dll`
+- `gstaudiomixer.dll`
+- `gstaudioparsers.dll`
+- `gstaudiorate.dll`
+- `gstaudioresample.dll`
+- `gstaudiotestsrc.dll`
+- `gstauparse.dll`
+- `gstautodetect.dll`
+- `gstbase-1.0-0.dll`
+- `gstcoreelements.dll`
+- `gstdirectsound.dll`
+- `gsticydemux.dll`
+- `gstid3demux.dll`
+- `gstisomp4.dll`
+- `gstmediafoundation.dll`
+- `gstmulaw.dll`
+- `gstogg.dll`
+- `gstopus.dll`
+- `gstpbutils-1.0-0.dll`
+- `gstplayback.dll`
+- `gstreamer-1.0-0.dll`
+- `gstriff-1.0-0.dll`
+- `gstrtp-1.0-0.dll`
+- `gstsoup.dll`
+- `gsttag-1.0-0.dll`
+- `gsttypefindfunctions.dll`
+- `gstvideo-1.0-0.dll`
+- `gstvolume.dll`
+- `gstvorbis.dll`
+- `gstwavparse.dll`
+- `gstwinrt-1.0-0.dll`
+- `gtk-4-1.dll`
+- `gtksourceview-5-0.dll`
+- `harfbuzz-cairo.dll`
+- `harfbuzz-gobject.dll`
+- `harfbuzz-gpu.dll`
+- `harfbuzz-raster.dll`
+- `harfbuzz-subset.dll`
+- `harfbuzz-vector.dll`
+- `harfbuzz.dll`
+- `iconv.dll`
+- `icudt78.dll`
+- `icuuc78.dll`
+- `intl.dll`
+- `jpeg62.dll`
+- `k5sprt64.dll`
+- `krb5_64.dll`
+- `libcrypto-3-arm64.dll`
+- `libexpat.dll`
+- `libpng16.dll`
+- `libssl-3-arm64.dll`
+- `nghttp2.dll`
+- `opus-0.dll`
+- `orc-0.4-0.dll`
+- `pango-1.0-0.dll`
+- `pangocairo-1.0-0.dll`
+- `pangoft2-1.0-0.dll`
+- `pangowin32-1.0-0.dll`
+- `pcre2-8-0.dll`
+- `pixbufloader_svg.dll`
+- `pixman-1-0.dll`
+- `psl-5.dll`
+- `rsvg-2-2.dll`
+- `soup-3.0-0.dll`
+- `sqlite3.dll`
+- `tiff.dll`
+- `xml2-16.dll`
+- `zlib1.dll`

package/gtk/etc/fonts/conf.d/10-hinting-slight.conf

@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+  <description>Set hintslight to hintstyle</description>
+
+  <match target="pattern">
+    <!--
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
+    -->
+    <edit name="hintstyle" mode="append"><const>hintslight</const></edit>
+  </match>
+</fontconfig>

package/gtk/etc/fonts/conf.d/10-scale-bitmap-fonts.conf

@@ -0,0 +1,83 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+  <description>Bitmap scaling</description>
+<!--
+  If font is bitmap, calculate scale factor.
+  Note that color bitmap fonts have scalable=true, while
+  non-color ones have scalable=false.  Both groups have outline=false.
+  -->
+<match target="font">
+  <test name="outline" compare="eq">
+    <bool>false</bool>
+  </test>
+  <edit name="pixelsizefixupfactor" mode="assign">
+    <divide>
+      <name target="pattern">pixelsize</name>
+      <name target="font"   >pixelsize</name>
+    </divide>
+  </edit>
+</match>
+<!--
+  For non-scalable bitmap fonts (ie. non-color), skip
+  minor scaling if hinting is enabled.
+  -->
+<match target="font">
+  <test name="outline" compare="eq">
+    <bool>false</bool>
+  </test>
+  <test name="scalable" compare="eq">
+    <bool>false</bool>
+  </test>
+  <test name="hinting" compare="eq">
+    <bool>true</bool>
+  </test>
+  <edit name="scalingnotneeded" mode="assign">
+    <and>
+      <less>
+        <name>pixelsizefixupfactor</name>
+        <double>1.2</double>
+      </less>
+      <more>
+        <name>pixelsizefixupfactor</name>
+        <double>0.8</double>
+      </more>
+    </and>
+  </edit>
+</match>
+<match target="font">
+  <test name="scalingnotneeded" compare="eq">
+    <bool>true</bool>
+  </test>
+  <edit name="pixelsizefixupfactor" mode="assign">
+    <double>1.0</double>
+  </edit>
+</match>
+<!--
+  If we *are* going to scale, go ahead and do it.
+  -->
+<match target="font">
+  <test name="outline" compare="eq">
+    <bool>false</bool>
+  </test>
+  <test name="pixelsizefixupfactor" compare="not_eq">
+    <double>1.0</double>
+  </test>
+  <edit name="matrix" mode="assign">
+    <times>
+      <name>matrix</name>
+      <matrix>
+        <name>pixelsizefixupfactor</name> <double>0</double>
+        <double>0</double> <name>pixelsizefixupfactor</name>
+       </matrix>
+    </times>
+  </edit>
+  <edit name="size" mode="assign">
+    <divide>
+      <name>size</name>
+      <name>pixelsizefixupfactor</name>
+    </divide>
+  </edit>
+</match>
+
+</fontconfig>

package/gtk/etc/fonts/conf.d/10-sub-pixel-none.conf

@@ -0,0 +1,15 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+  <description>Disable sub-pixel rendering</description>
+<!--  Disable sub-pixel rendering --> 
+  <match target="pattern">
+    <!--
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
+    -->
+    <edit name="rgba" mode="append"><const>none</const></edit>
+  </match>
+</fontconfig>

package/gtk/etc/fonts/conf.d/10-yes-antialias.conf

@@ -0,0 +1,8 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+  <description>Enable antialiasing</description>
+  <match target="pattern">
+    <edit name="antialias" mode="append"><bool>true</bool></edit>
+  </match>
+</fontconfig>

package/gtk/etc/fonts/conf.d/11-lcdfilter-default.conf

@@ -0,0 +1,17 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+  <description>Use lcddefault as default for LCD filter</description>
+<!--  Use lcddefault as default for LCD filter -->
+  <match target="pattern">
+    <!--
+      This sort of configuration is available on the major desktop environments
+      and we don't have to break it with "assign" unconditionally. however, we
+      want to set something for others. So we use "append" here to get this working
+      in both cases so that most clients would takes a look at the first place only.
+    -->
+    <edit mode="append" name="lcdfilter">
+      <const>lcddefault</const>
+    </edit>
+  </match>
+</fontconfig>

package/gtk/etc/fonts/conf.d/20-unhint-small-vera.conf

@@ -0,0 +1,49 @@
+<?xml version="1.0"?>
+<!DOCTYPE fontconfig SYSTEM "urn:fontconfig:fonts.dtd">
+<fontconfig>
+  <description>Disable hinting for Bitstream Vera fonts when the size is less than 8ppem</description>
+<!-- 
+	The Bitstream Vera fonts have GASP entries suggesting that hinting be
+	disabled below 8 ppem, but FreeType ignores those, preferring to use
+	the data found in the instructed hints.  The initial Vera release
+	didn't include the right instructions in the 'prep' table. Fix this
+	by disabling hinting manually at smaller sizes (< 8ppem)
+ -->
+
+	<match target="font">
+		<test name="family" compare="eq" ignore-blanks="true">
+			<string>Bitstream Vera Sans</string>
+		</test>
+		<test name="pixelsize" compare="less">
+			<double>7.5</double>
+		</test>
+		<edit name="hinting">
+			<bool>false</bool>
+		</edit>
+	</match>
+
+	<match target="font">
+		<test name="family" compare="eq" ignore-blanks="true">
+			<string>Bitstream Vera Serif</string>
+		</test>
+		<test name="pixelsize" compare="less">
+			<double>7.5</double>
+		</test>
+		<edit name="hinting">
+			<bool>false</bool>
+		</edit>
+	</match>
+
+	<match target="font">
+		<test name="family" compare="eq" ignore-blanks="true">
+			<string>Bitstream Vera Sans Mono</string>
+		</test>
+		<test name="pixelsize" compare="less">
+			<double>7.5</double>
+		</test>
+		<edit name="hinting">
+			<bool>false</bool>
+		</edit>
+	</match>
+
+</fontconfig>