tycho · Oct 25, 2026 · Oct 25, 2026 · Oct 25, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -7,6 +7,16 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.5](https://github.com/tycho/gloam/compare/0.7.4...0.7.5) - 2026-10-25
+
+### Added
+
+- *(examples)* AppKit/Metal surface support in vk-cube-rs
+
+### Fixed
+
+- *(c)* find the Vulkan SDK loader on macOS without DYLD_LIBRARY_PATH
+
 ## [0.7.4](https://github.com/tycho/gloam/compare/0.7.3...0.7.4) - 2026-10-25
 
 ### Other

diff --git a/Cargo.lock b/Cargo.lock
diff --git a/Cargo.toml b/Cargo.toml
@@ -3,7 +3,7 @@ members = ["xtask"]
 
 [package]
 name           = "gloam"
-version        = "0.7.4"
+version        = "0.7.5"
 edition        = "2024"
 description    = "Loader generator for Vulkan, OpenGL, OpenGL ES, EGL, GLX, and WGL"
 license        = "MIT OR Apache-2.0"

diff --git a/docs/c-loader.md b/docs/c-loader.md
@@ -153,7 +153,9 @@ The version and extension lists are the same values you passed to
 phase returns nonzero on success. Details:
 
 - `gloamVulkanInitialize(NULL)` finds and opens the platform Vulkan
-  library (`vulkan-1.dll`, `libvulkan.so.1`, `libvulkan.dylib`); pass
+  library (`vulkan-1.dll`, `libvulkan.so.1`, `libvulkan.dylib`; on macOS
+  it also tries `/usr/local/lib` and `/opt/homebrew/lib` by path, since
+  dyld no longer searches them for bare names); pass
   your own library handle instead to control the open. If you already
   have a `vkGetInstanceProcAddr`, skip the library entirely with
   `gloamVulkanInitializeCustom(getInstanceProcAddr)`.

diff --git a/examples/README.md b/examples/README.md
@@ -10,7 +10,7 @@ gloam is to generate once and commit the result to your project.
 | [c/vk-cube](c/vk-cube/) | C | Real Vulkan rendering: a spinning cube with a swapchain (recreated on resize), depth buffer, explicit layout barriers around 1.3 dynamic rendering, and two frames in flight — SDL3 window, `SDL_Vulkan_CreateSurface`, loader opened by the built-in `--loader`. |
 | [c/vk-info](c/vk-info/) | C | The phased Vulkan flow (`Initialize → LoadInstance → LoadDevice`) with the built-in `--loader` opening the platform Vulkan library — headless device info plus a cross-check of gloam's extension flags against what was actually enabled. |
 | [rust/gl-triangle](rust/gl-triangle/) | Rust | The generated loader as a crate (`gloam_gl`), consumed via the Rust-native `winit` + `glutin` stack: a desktop GL 3.3 context, `--mx-global` free-function dispatch, and a spinning triangle. |
-| [rust/vk-cube](rust/vk-cube/) | Rust | The same cube on the owned-context `Vk` API, `winit` windowing, and the surface created through the loader's own `vkCreate*SurfaceKHR` platform commands (selected from the `raw-window-handle` at runtime). |
+| [rust/vk-cube](rust/vk-cube/) | Rust | The same cube on the owned-context `Vk` API, `winit` windowing, and the surface created through the loader's own `vkCreate*SurfaceKHR` / `vkCreateMetalSurfaceEXT` platform commands (selected from the `raw-window-handle` at runtime). |
 | [rust/vk-info](rust/vk-info/) | Rust | The phased Vulkan flow on the `gloam_vk` crate's `--mx-global` layer: `vk::initialize → load_instance → load_device`, headless device info, and per-extension presence flags. |
 | [rust/egl-info](rust/egl-info/) | Rust | The `gloam_egl` crate probing EGL client extensions, then initializing each ANGLE render backend via `EGL_ANGLE_platform_angle` (or the default display on plain EGL). |
 

diff --git a/examples/c/vk-cube/gloam/.gloam/manifest.json b/examples/c/vk-cube/gloam/.gloam/manifest.json
@@ -1,9 +1,9 @@
 {
   "schema_version": 2,
   "gloam": {
-    "version": "0.7.3",
-    "describe": "0.7.3+52cdcce.dirty",
-    "commit": "52cdcce2d94939cd4da05037893c9f85acfcd0bf",
+    "version": "0.7.4",
+    "describe": "0.7.3-5-g1ea3207",
+    "commit": "1ea32073fbb1321252e60047faf8b5761c8ab9b5",
     "command_line": "gloam --api vk=1.3 --extensions VK_KHR_surface,VK_KHR_swapchain,VK_KHR_get_physical_device_properties2,VK_KHR_portability_enumeration,VK_KHR_portability_subset --out-path examples/c/vk-cube/gloam c --loader"
   },
   "provenance": {
@@ -32,7 +32,7 @@
   "output": [
     {
       "path": "include/gloam/vk.h",
-      "blob": "9b91253222069dc0899522e08116d1d74f23e5a3",
+      "blob": "8953c18875bfb4602539d963a0ae9a515b7c0264",
       "derived_from": [
         "vk.xml",
         "vulkan/vk_platform.h",
@@ -57,7 +57,7 @@
     },
     {
       "path": "src/vk.c",
-      "blob": "685959bd5c19e474b2e67811a2e5ced93d6adbd8",
+      "blob": "92c71497ebd6ee84dea3c77877171c93bd1a7634",
       "derived_from": [
         "vk.xml",
         "vulkan/vk_platform.h",

diff --git a/examples/c/vk-cube/gloam/include/gloam/vk.h b/examples/c/vk-cube/gloam/include/gloam/vk.h
@@ -1,5 +1,5 @@
 /*
- * @generated by gloam 0.7.3+52cdcce.dirty.
+ * @generated by gloam 0.7.3-5-g1ea3207.
  *
  *   gloam --api vk=1.3 --extensions VK_KHR_surface,VK_KHR_swapchain,VK_KHR_get_physical_device_properties2,VK_KHR_portability_enumeration,VK_KHR_portability_subset --out-path examples/c/vk-cube/gloam c --loader
  *

diff --git a/examples/c/vk-cube/gloam/src/vk.c b/examples/c/vk-cube/gloam/src/vk.c
@@ -1,5 +1,5 @@
 /*
- * @generated by gloam 0.7.3+52cdcce.dirty.
+ * @generated by gloam 0.7.3-5-g1ea3207.
  *
  *   gloam --api vk=1.3 --extensions VK_KHR_surface,VK_KHR_swapchain,VK_KHR_get_physical_device_properties2,VK_KHR_portability_enumeration,VK_KHR_portability_subset --out-path examples/c/vk-cube/gloam c --loader
  *
@@ -256,6 +256,9 @@ static void *gloam_open_library(const char * const *names, int count)
 static const char * const gloam_vk_lib_names[] = {
 #if defined(__APPLE__)
     "libvulkan.dylib", "libvulkan.1.dylib", "libMoltenVK.dylib",
+    /* dyld no longer falls back to /usr/local/lib for bare names, but the
+       LunarG SDK installs there (Homebrew uses /opt/homebrew/lib). */
+    "/usr/local/lib/libvulkan.1.dylib", "/opt/homebrew/lib/libvulkan.1.dylib",
 #elif defined(GLOAM_PLATFORM_WINDOWS)
     "vulkan-1.dll",
 #else

diff --git a/examples/c/vk-info/gloam/.gloam/manifest.json b/examples/c/vk-info/gloam/.gloam/manifest.json
@@ -1,9 +1,9 @@
 {
   "schema_version": 2,
   "gloam": {
-    "version": "0.7.3",
-    "describe": "0.7.3+52cdcce.dirty",
-    "commit": "52cdcce2d94939cd4da05037893c9f85acfcd0bf",
+    "version": "0.7.4",
+    "describe": "0.7.3-5-g1ea3207",
+    "commit": "1ea32073fbb1321252e60047faf8b5761c8ab9b5",
     "command_line": "gloam --api vk=1.3 --extensions VK_KHR_swapchain,VK_KHR_get_physical_device_properties2,VK_EXT_debug_utils,VK_KHR_timeline_semaphore,VK_KHR_synchronization2,VK_KHR_portability_enumeration --out-path vk-info/gloam c --loader"
   },
   "provenance": {
@@ -32,7 +32,7 @@
   "output": [
     {
       "path": "include/gloam/vk.h",
-      "blob": "db631d612f891060444d182135623eff05239de1",
+      "blob": "120ad96ae66d72a838aba91a025cce9aa8dd74cf",
       "derived_from": [
         "vk.xml",
         "vulkan/vk_platform.h",
@@ -57,7 +57,7 @@
     },
     {
       "path": "src/vk.c",
-      "blob": "45db525b00789529e658b4cb57a76c34ac075d00",
+      "blob": "c9ecd76e9b95a088e965a6adb20be7095b3e6d9a",
       "derived_from": [
         "vk.xml",
         "vulkan/vk_platform.h",

diff --git a/examples/c/vk-info/gloam/include/gloam/vk.h b/examples/c/vk-info/gloam/include/gloam/vk.h
@@ -1,5 +1,5 @@
 /*
- * @generated by gloam 0.7.3+52cdcce.dirty.
+ * @generated by gloam 0.7.3-5-g1ea3207.
  *
  *   gloam --api vk=1.3 --extensions VK_KHR_swapchain,VK_KHR_get_physical_device_properties2,VK_EXT_debug_utils,VK_KHR_timeline_semaphore,VK_KHR_synchronization2,VK_KHR_portability_enumeration --out-path vk-info/gloam c --loader
  *

diff --git a/examples/c/vk-info/gloam/src/vk.c b/examples/c/vk-info/gloam/src/vk.c
@@ -1,5 +1,5 @@
 /*
- * @generated by gloam 0.7.3+52cdcce.dirty.
+ * @generated by gloam 0.7.3-5-g1ea3207.
  *
  *   gloam --api vk=1.3 --extensions VK_KHR_swapchain,VK_KHR_get_physical_device_properties2,VK_EXT_debug_utils,VK_KHR_timeline_semaphore,VK_KHR_synchronization2,VK_KHR_portability_enumeration --out-path vk-info/gloam c --loader
  *
@@ -257,6 +257,9 @@ static void *gloam_open_library(const char * const *names, int count)
 static const char * const gloam_vk_lib_names[] = {
 #if defined(__APPLE__)
     "libvulkan.dylib", "libvulkan.1.dylib", "libMoltenVK.dylib",
+    /* dyld no longer falls back to /usr/local/lib for bare names, but the
+       LunarG SDK installs there (Homebrew uses /opt/homebrew/lib). */
+    "/usr/local/lib/libvulkan.1.dylib", "/opt/homebrew/lib/libvulkan.1.dylib",
 #elif defined(GLOAM_PLATFORM_WINDOWS)
     "vulkan-1.dll",
 #else