@gjsify/gtk-quartz-native 0.0.0-stage → 0.64.30

package/README.md

@@ -1,3 +1,25 @@
-# Temporary Holding Version
+# @gjsify/gtk-quartz-native
 
-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.
+Makes a Dock click on a windowless macOS app activate the `GApplication`.
+
+Decision and measurements: [ADR 0140](../../../docs/adr/0140-a-dock-click-reopens-the-application-on-macos.md).
+
+GTK 4.24.1's `GtkApplicationQuartzDelegate` does not implement
+`applicationShouldHandleReopen:hasVisibleWindows:`, so the click is dropped. This package adds the
+method through the Objective-C runtime (`class_addMethod`). It fails, and so does nothing, once the
+loaded GTK has the method: the bridge retires itself.
+
+```ts
+import GjsifyQuartz from 'gi://GjsifyQuartz?version=1.0';
+GjsifyQuartz.install_reopen_handler(); // true if this call installed it
+```
+
+`@gjsify/adwaita-app` calls it for you on darwin. The library links neither GTK nor GLib; the
+class is looked up by name at run time. No JavaScript; the prebuilt library and typelib arrive via
+the per-target `optionalDependencies`.
+
+## Tests
+
+```sh
+gjsify run test:meson   # darwin only; needs host gtk4, glib, gjs
+```

package/package.json

@@ -1,6 +1,62 @@
 {
-  "name": "@gjsify/gtk-quartz-native",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+    "name": "@gjsify/gtk-quartz-native",
+    "version": "0.64.30",
+    "description": "Adds the missing Dock-click reopen handler to GTK's macOS application delegate, so a click on a windowless app's Dock icon activates the GApplication (ADR 0140). Contains no JavaScript; the prebuilt library and typelib arrive through per-target optionalDependencies.",
+    "type": "module",
+    "files": [],
+    "gjsify": {
+        "platforms": [
+            "darwin-x64",
+            "darwin-arm64"
+        ],
+        "runtimes": {
+            "gjs": "polyfill",
+            "node": "none",
+            "browser": "none",
+            "nativescript": "none"
+        },
+        "os": {
+            "linux": "none",
+            "darwin": "supported",
+            "win32": "none"
+        },
+        "osNotes": {
+            "linux": "Patches GtkApplicationQuartzDelegate, a class of GTK's macOS backend; GTK on Linux has no such class and desktops activate a running application through D-Bus.",
+            "win32": "Patches GtkApplicationQuartzDelegate, a class of GTK's macOS backend; GTK on Windows has no such class."
+        },
+        "tier": 1
+    },
+    "scripts": {
+        "clear": "gjsify clear build _install",
+        "check": "echo 'no TypeScript in this package'",
+        "init:meson": "meson setup build .",
+        "init:meson:wipe": "gjsify run init:meson --wipe",
+        "build": "echo 'native only — see build:prebuilds'",
+        "build:meson": "gjsify run init:meson && meson compile -C build",
+        "build:prebuilds": "gjsify run build:meson && node ../../../scripts/stage-prebuild.mjs .",
+        "test": "echo 'darwin only — run test:meson'",
+        "test:meson": "gjsify run build:meson && meson test -C build --print-errorlogs"
+    },
+    "keywords": [
+        "gjs",
+        "gtk",
+        "quartz",
+        "darwin",
+        "macos",
+        "dock"
+    ],
+    "license": "MIT",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/gjsify/gjsify.git",
+        "directory": "packages/framework/gtk-quartz-native"
+    },
+    "bugs": {
+        "url": "https://github.com/gjsify/gjsify/issues"
+    },
+    "homepage": "https://github.com/gjsify/gjsify/tree/main/packages/framework/gtk-quartz-native#readme",
+    "optionalDependencies": {
+        "@gjsify/gtk-quartz-native-darwin-arm64": "0.64.30",
+        "@gjsify/gtk-quartz-native-darwin-x64": "0.64.30"
+    }
+}