@gjsify/gtk-runtime-darwin-arm64 0.19.0 → 0.21.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.21.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",

package/scripts/build-gtk-runtime.mjs

@@ -74,6 +74,23 @@ const SEED_PATTERNS = [
     /^libgtk-4\..*\.dylib$/, // provides the Gdk typelib's backing library
 ];
 
+// WINDOWING superset (opt-in via --windowing): also bundle libadwaita, whose dylib
+// backs the Adw-1 typelib, AND libgtksourceview-5, whose dylib backs the GtkSource-5
+// typelib. The display-free conformance closure never touches Adwaita OR GtkSource,
+// so they are NOT base seeds — but the batteries-included bundle ships their TYPELIBS,
+// so without the dylibs a real `new Adw.Application()` / `new GtkSource.View()` fails
+// with "Failed to load shared library '…'" (→ the type is not a constructible
+// GObject). libgtksourceview backs the Learn6502 editor (a GtkSource.View subclass) —
+// the app-gnome node-gi port. This is exactly what the macOS GTK-GUI proof
+// (macos-gtk-windowing) needs; the recursive otool walk pulls each seed's transitive
+// deps + relocates them like any other seed. Mirrors the win32 --windowing superset
+// (WINDOWING_SEED_PATTERNS there). NB: GtkSource's runtime DATA (language-specs /
+// styles under share/gtksourceview-5) is a separate concern; the darwin bundle has no
+// share/ DATA step yet, so GtkSource CONSTRUCTS here but syntax-highlighting language
+// files are not bundled (tracked follow-up; the win32 bundle DOES ship them).
+const WINDOWING = process.argv.includes('--windowing');
+const WINDOWING_SEED_PATTERNS = [/^libadwaita-1\..*\.dylib$/, /^libgtksourceview-5\..*\.dylib$/];
+
 function isSystemPath(p) {
     return p.startsWith('/usr/lib/') || p.startsWith('/System/');
 }
@@ -112,8 +129,9 @@ function resolveInBrew(leaf) {
 }
 
 // --- 1. discover the closure ----------------------------------------------
-console.log(`build-gtk-runtime: brew prefix ${brewPrefix}`);
-const seeds = readdirSync(brewLib).filter((f) => SEED_PATTERNS.some((re) => re.test(f)));
+console.log(`build-gtk-runtime: brew prefix ${brewPrefix}${WINDOWING ? ' (windowing superset — + libadwaita + libgtksourceview)' : ' (display-free)'}`);
+const seedPatterns = WINDOWING ? [...SEED_PATTERNS, ...WINDOWING_SEED_PATTERNS] : SEED_PATTERNS;
+const seeds = readdirSync(brewLib).filter((f) => seedPatterns.some((re) => re.test(f)));
 if (seeds.length === 0) {
     console.error('build-gtk-runtime: no seed libraries found — is the GTK stack installed?');
     process.exit(1);