@gjsify/gtk-runtime-darwin-arm64 0.19.0 → 0.20.0

package/README.md

@@ -71,6 +71,37 @@ The re-exec is a no-op off darwin, without a bundle, or once the fallback alread
 covers the bundle — so it costs one extra `exec` only on the first macOS load of a
 batteries-included install, and nothing elsewhere.
 
+## Release flow — how the `gtk/` bundle reaches npm
+
+The `gtk/` payload is gitignored and built ONLY on macOS/arm64, so it cannot be
+produced by the main (ubuntu) release publish. A dedicated macOS job in
+[`.github/workflows/release.yml`](../../../.github/workflows/release.yml) —
+`publish-gtk-runtime-darwin-arm64` — owns this package's publish end to end:
+
+1. On `release: published` it checks out the tag (the version `@release-it/bumper`
+   already bumped in this package's `package.json`, in lockstep with the train).
+2. `brew install`s the GTK/GI stack as the build-time closure **source**.
+3. Runs `scripts/build-gtk-runtime.mjs --out gtk` to populate `gtk/` (relocated
+   dylibs + typelibs + `manifest.json`), then asserts no `/opt/homebrew` refs
+   survived and that `gtk/lib` + `gtk/girepository-1.0` exist (the two dirs
+   [`index.js`](./index.js)'s `isPresent` gate checks).
+4. OIDC-publishes **only this package** (Trusted Publisher configured for
+   `release.yml`), so `files: ["gtk"]` ships the whole bundle recursively (the
+   gjsify packer expands a plain-directory `files` entry). Consumers then see
+   `isPresent === true` and get the "no Homebrew needed" path.
+
+The main ubuntu publish job never touches this package — `packages/node-gi/*` is
+not a root workspace, so `gjsify foreach` (its enumerator) never sees it. That is
+also why the first bare `0.19.0` was an empty ~18 KB shell: nothing built `gtk/`
+before publish. This job is the fix; the addon-relocation `--addon`/`--stage`
+flags of the build script are a *separate* node-gi concern (see
+[`node-gi.yml`](../../../.github/workflows/node-gi.yml) → `macos-gtk-runtime`) and
+are **not** part of this tarball.
+
+**This is the PATTERN the future Windows sibling `@gjsify/gtk-runtime-win32-x64`
+will mirror**: a `windows-latest` publish job using the gvsbuild GTK stack as its
+closure source and its own MSVC-ABI relocation step, publishing only that package.
+
 ## Scope & what a full windowing bundle still needs
 
 This bundle targets the **display-free conformance closure only**. The full

package/gtk/manifest.json

@@ -0,0 +1,56 @@
+{
+  "platform": "darwin-arm64",
+  "generatedFrom": "/opt/homebrew",
+  "dylibs": 45,
+  "typelibs": 38,
+  "libBytes": 29101712,
+  "typelibBytes": 2342100,
+  "totalBytes": 31443812,
+  "dylibList": [
+    "libX11.6.dylib",
+    "libXau.6.dylib",
+    "libXdmcp.6.dylib",
+    "libXext.6.dylib",
+    "libXrender.1.dylib",
+    "libcairo-gobject.2.dylib",
+    "libcairo-gobject.dylib",
+    "libcairo-script-interpreter.2.dylib",
+    "libcairo-script-interpreter.dylib",
+    "libcairo.2.dylib",
+    "libcairo.dylib",
+    "libdatrie.1.dylib",
+    "libepoxy.0.dylib",
+    "libfontconfig.1.dylib",
+    "libfreetype.6.dylib",
+    "libfribidi.0.dylib",
+    "libgdk_pixbuf-2.0.0.dylib",
+    "libgio-2.0.0.dylib",
+    "libgirepository-2.0.0.dylib",
+    "libglib-2.0.0.dylib",
+    "libgmodule-2.0.0.dylib",
+    "libgobject-2.0.0.dylib",
+    "libgraphene-1.0.0.dylib",
+    "libgraphite2.3.dylib",
+    "libgtk-4.1.dylib",
+    "libharfbuzz-subset.0.dylib",
+    "libharfbuzz.0.dylib",
+    "libintl.8.dylib",
+    "libjpeg.8.dylib",
+    "liblzma.5.dylib",
+    "liblzo2.2.dylib",
+    "libpango-1.0.0.dylib",
+    "libpangocairo-1.0.0.dylib",
+    "libpangoft2-1.0.0.dylib",
+    "libpcre2-8.0.dylib",
+    "libpixman-1.0.dylib",
+    "libpng16.16.dylib",
+    "libsharpyuv.0.dylib",
+    "libthai.0.dylib",
+    "libtiff.6.dylib",
+    "libwebp.7.dylib",
+    "libxcb-render.0.dylib",
+    "libxcb-shm.0.dylib",
+    "libxcb.1.dylib",
+    "libzstd.1.dylib"
+  ]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gjsify/gtk-runtime-darwin-arm64",
-  "version": "0.19.0",
+  "version": "0.20.0",
   "description": "Batteries-included, relocated GTK/GObject-Introspection runtime bundle for macOS arm64 — lets @gjsify/node-gi load gi:// namespaces (GLib/GObject/Gio/cairo/Pango/Graphene/Gdk) with NO Homebrew GTK. Platform-gated (darwin/arm64 only).",
   "type": "module",
   "license": "MIT",