@gjsify/gtk-runtime-win32-x64 0.27.1 → 0.29.0

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

@@ -8,16 +8,25 @@ the host — the Windows sibling of `@gjsify/gtk-runtime-darwin-arm64`.
 Platform-gated (`os: ["win32"]`, `cpu: ["x64"]`), 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 CI
-runner (`scripts/build-gtk-runtime.mjs`) and shipped via the package tarball /
-staged into node-gi's `prebuilds/win32-x64/gtk/`.
+runner (`scripts/build-gtk-runtime.mjs` in the gjsify repo) and shipped via the
+package tarball / staged into node-gi's `prebuilds/win32-x64/gtk/`.
+
+The tarball does **not** carry the builder (it imports shared rules from
+`packages/node-gi/scripts/`, which only exist in the repo); `gtk/manifest.json`
+records the script's repo path under `builder` so a consumer holding only the tarball
+can find the recipe that produced its bytes — the same convention the darwin
+siblings use.
 
 ## Layout
 
 ```
 gtk/
-  bin/                 GTK/GLib/cairo/pango/graphene/gdk-pixbuf DLLs (+ deps)
-  girepository-1.0/    typelibs (GLib/GObject/Gio/cairo/Pango/Graphene/Gdk/…)
-  manifest.json        counts + sizes + DLL list
+  bin/                     GTK/GLib/cairo/pango/graphene/gdk-pixbuf DLLs (+ deps)
+  girepository-1.0/        typelibs — ONLY those this bundle can back (see below)
+  lib/ share/ etc/         --windowing only: pixbuf loaders, schemas, icons, fontconfig
+  licenses/                license texts recovered from the gvsbuild prefix
+  THIRD-PARTY-NOTICES.md   what is bundled, under which terms, and that it is unmodified
+  manifest.json            counts + sizes + DLL list + symmetry/license proof
 ```
 
 Note the native code lives in **`gtk/bin`** (DLLs), not `gtk/lib` — on Windows the
@@ -42,7 +51,24 @@ not shipped):
    job.** There is **no** `install_name_tool`/`@rpath`/`codesign` step: Windows
    resolves a DLL's imports by **search path** at `LoadLibrary` time, so a directory
    of DLLs is portable the moment it exists — no per-file rewriting, no re-signing.
-3. **Typelibs** — copy the typelib set into `gtk/girepository-1.0`.
+3. **Typelibs** — copy into `gtk/girepository-1.0` **only the typelibs this bundle
+   can back**. GI resolves a namespace's symbols with `g_module_open(<shared_library>)`
+   out of the typelib's own header, so a typelib whose DLL is absent yields a namespace
+   that resolves, advertises its classes and then dies in the constructor with
+   `Failed to load shared library '…'`. Measured on the published 0.27.1 tarball: 3 of
+   37 typelibs were in that state (`Adw-1`, `GtkSource-5`, `Rsvg-2.0`). The rule reads
+   the mapping out of each typelib (never a name table — gvsbuild records
+   `adwaita-1-0.dll` where brew records `libadwaita-1.0.dylib`), refuses to drop a
+   typelib that a kept one DEPENDS on (that is a build failure naming the missing DLL,
+   because `gi_repository_require` loads dependencies first), and re-verifies the
+   finished bundle off disk against a floor of namespaces that must be present. Shared
+   with the darwin builder: [`../scripts/typelib-backers.mjs`](../scripts/typelib-backers.mjs).
+4. **Licenses** — copy the license corpus the gvsbuild prefix documents
+   (`share/doc/<project>/COPYING|LICENSE`, `share/licenses/<project>/*`) into
+   `gtk/licenses/` and write `gtk/THIRD-PARTY-NOTICES.md`, which lists every bundled
+   DLL and states that the DLLs are byte-identical copies (no relocation on Windows).
+   Per-DLL attribution is deliberately NOT invented: the prefix is one flat build tree,
+   so the whole corpus ships and the notice says the mapping is not recoverable.
 
 Contrast with macOS, where dyld bakes each dylib's dependency install-names, so the
 darwin bundle must rewrite every reference to `@loader_path/<leaf>` and ad-hoc
@@ -90,7 +116,8 @@ both sufficient and the simplest mechanism.
 `build-gtk-runtime.mjs` builds one of two supersets into the same `gtk/` dir:
 
 - **Default (display-free)** — the DLL closure + typelibs the display-free
-  conformance needs. `manifest.windowing === false`. Unchanged.
+  conformance needs. `manifest.windowing === false`. This is the CONFORMANCE variant
+  `node-gi.yml` builds.
 - **`--windowing` (superset)** — everything above **plus** the runtime DATA a real
   GTK window needs on Windows, so a `Adw.ApplicationWindow` realizes + renders with
   no gvsbuild/system GTK:
@@ -119,6 +146,11 @@ both sufficient and the simplest mechanism.
   Each data step is defensive — a missing tree/tool WARNs and continues (the DLL +
   typelib bundle is always produced).
 
+  **This is the variant that gets PUBLISHED** (since 0.27.2). Up to and including
+  0.27.1 `release.yml` built the display-free variant, so the tarball on npm had
+  `"windowing": false`, `"dataBytes": 0`, no pixbuf loaders, no compiled schemas, no
+  icon themes — and `GtkSource-5.typelib` with no gtksourceview DLL behind it.
+
 ### How node-gi wires the windowing data
 
 `@gjsify/node-gi`'s loader (`gtk-runtime.js` `maybeWireGtkWindowingEnv`, run at

package/gtk/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,99 @@
+# Third-party notices
+
+This directory is a self-contained GTK / GObject-Introspection runtime for **win32-x64**, 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/gtk-runtime-win32-x64/scripts/build-gtk-runtime.mjs`
+- Build prefix (source of every binary): `C:\gtk-build\gtk\x64\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.
+
+| Component | Version | License (as declared by the build prefix) | Texts included |
+|---|---|---|---|
+| adwaita-icon-theme | — | (see included text) | COPYING_CCBYSA3, COPYING, COPYING_LGPL |
+| cairo | — | (see included text) | COPYING |
+| cairomm | — | (see included text) | COPYING |
+| directx-headers | — | (see included text) | LICENSE |
+| expat | — | (see included text) | AUTHORS, COPYING |
+| fontconfig | — | (see included text) | COPYING |
+| fribidi | — | (see included text) | COPYING |
+| gdk-pixbuf | — | (see included text) | COPYING |
+| gettext | — | (see included text) | COPYING |
+| glibmm | — | (see included text) | COPYING |
+| gperf | — | (see included text) | COPYING |
+| gtk4 | — | (see included text) | COPYING |
+| gtkmm | — | (see included text) | COPYING |
+| gtksourceview5 | — | (see included text) | COPYING |
+| harfbuzz | — | (see included text) | COPYING |
+| 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 |
+| librsvg | — | (see included text) | COPYING.LIB |
+| libsigc++ | — | (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 |
+| protobuf | — | (see included text) | LICENSE |
+| protobuf-c | — | (see included text) | LICENSE |
+| pycairo | — | (see included text) | COPYING, COPYING-LGPL-2.1, COPYING-MPL-1.1 |
+| pygobject | — | (see included text) | COPYING |
+| win-iconv | — | (see included text) | COPYING |
+
+31 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`
+- `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`
+- `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`
+- `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`
+- `intl.dll`
+- `jpeg62.dll`
+- `libexpat.dll`
+- `libpng16.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`
+- `pixman-1-0.dll`
+- `rsvg-2-2.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>