wyvrnpm 2.10.2 → 2.12.2

package/src/settings-overrides.js

@@ -1,152 +1,152 @@
-'use strict';
-
-// Pattern-based settings overrides (EVALUATION.md F11).
-//
-// `wyvrn.json` may declare a top-level `settingsOverrides` block whose
-// keys are glob patterns over dependency names. Every matching pattern
-// contributes to the resolved dep's `settings` merge; the per-dep
-// literal settings (inside `dependencies`) still win over patterns.
-//
-// Conan users know this feature as profile-side `boost*:compiler.cppstd=17`.
-// Ours lives in the manifest because that's where literal settings
-// overrides already live — one fewer concept for recipe authors.
-//
-// Pure, no I/O. Exported helpers:
-//   - normalizeSettingsOverrides: validate + sort by specificity
-//   - resolveOverrideSettings: compute the merged settings for a dep name
-
-/**
- * Valid profile field keys that settings overrides may target.
- * Mirrors `HASHED_PROFILE_FIELDS` in src/profile.js, but as the allow-
- * list for OVERRIDE values (os/arch/compiler/etc.). If a pattern
- * override tries to set something else, reject at parse time rather
- * than silently letting it through into mergeProfile.
- */
-const ALLOWED_SETTINGS_KEYS = new Set([
-  'os', 'arch', 'compiler', 'compiler.version', 'compiler.cppstd', 'compiler.runtime',
-]);
-
-/**
- * Convert a glob pattern to a RegExp. Supports `*` (any chars),
- * `?` (single char), literal everything else. No brace expansion,
- * no negation — keep the mental model small.
- *
- * @param {string} glob
- * @returns {RegExp}
- */
-function globToRegExp(glob) {
-  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&');
-  const pattern = escaped.replace(/\*/g, '.*').replace(/\?/g, '.');
-  return new RegExp(`^${pattern}$`);
-}
-
-/**
- * Specificity heuristic: fewer wildcards = more specific. Ties broken
- * by longer literal prefix, then lexical order for determinism. More
- * specific patterns get applied LAST so they override less-specific
- * ones in the merge.
- *
- * @param {string} glob
- * @returns {[number, number, string]} sort key — lower = less specific
- */
-function specificityKey(glob) {
-  const wildcards = (glob.match(/[*?]/g) ?? []).length;
-  const literalPrefix = glob.match(/^[^*?]*/)?.[0].length ?? 0;
-  // Invert sort order: more wildcards → lower score; more prefix → higher score.
-  return [-wildcards, literalPrefix, glob];
-}
-
-/**
- * Validate + sort a raw `settingsOverrides` block. Returns an array of
- * `{ pattern, regex, settings }` in application order (least-specific
- * first). A string pattern alone (literal `"openssl"`) works too — it
- * matches only that exact name.
- *
- * Throws on:
- *  - non-object block
- *  - non-string keys (JSON can't produce these but defensive)
- *  - non-object values
- *  - empty pattern strings
- *  - unknown settings keys in a value
- *  - non-string value leaves (settings values must be strings like
- *    the profile itself: "dynamic", "17", "gcc")
- *
- * @param {unknown} block
- * @returns {Array<{ pattern: string, regex: RegExp, settings: Record<string, string> }>}
- */
-function normalizeSettingsOverrides(block) {
-  if (block === undefined || block === null) return [];
-  if (typeof block !== 'object' || Array.isArray(block)) {
-    throw new Error('settingsOverrides must be an object mapping globs to settings');
-  }
-
-  const entries = [];
-  for (const [rawPattern, rawValue] of Object.entries(block)) {
-    if (typeof rawPattern !== 'string' || rawPattern.length === 0) {
-      throw new Error(`settingsOverrides: pattern must be a non-empty string, got ${JSON.stringify(rawPattern)}`);
-    }
-    if (!rawValue || typeof rawValue !== 'object' || Array.isArray(rawValue)) {
-      throw new Error(`settingsOverrides["${rawPattern}"]: value must be an object of settings`);
-    }
-
-    const settings = {};
-    for (const [k, v] of Object.entries(rawValue)) {
-      if (!ALLOWED_SETTINGS_KEYS.has(k)) {
-        throw new Error(
-          `settingsOverrides["${rawPattern}"]: unknown key "${k}" — ` +
-          `allowed: ${[...ALLOWED_SETTINGS_KEYS].join(', ')}`,
-        );
-      }
-      if (typeof v !== 'string' || v.length === 0) {
-        throw new Error(
-          `settingsOverrides["${rawPattern}"].${k}: value must be a non-empty string, ` +
-          `got ${JSON.stringify(v)}`,
-        );
-      }
-      settings[k] = v;
-    }
-
-    entries.push({ pattern: rawPattern, regex: globToRegExp(rawPattern), settings });
-  }
-
-  // Sort by specificity ascending so more-specific patterns apply LAST
-  // (their settings therefore win on per-key merge).
-  entries.sort((a, b) => {
-    const ka = specificityKey(a.pattern);
-    const kb = specificityKey(b.pattern);
-    for (let i = 0; i < ka.length; i++) {
-      if (ka[i] < kb[i]) return -1;
-      if (ka[i] > kb[i]) return  1;
-    }
-    return 0;
-  });
-
-  return entries;
-}
-
-/**
- * Merge all matching pattern overrides for `depName` into a flat
- * settings object. Less-specific patterns apply first; more-specific
- * patterns overlay on top. Does NOT include the literal per-dep
- * `settings` (caller layers that on after — literal always wins).
- *
- * @param {string} depName
- * @param {ReturnType<typeof normalizeSettingsOverrides>} normalized
- * @returns {Record<string, string>}
- */
-function resolveOverrideSettings(depName, normalized) {
-  const out = {};
-  for (const entry of normalized) {
-    if (entry.regex.test(depName)) {
-      Object.assign(out, entry.settings);
-    }
-  }
-  return out;
-}
-
-module.exports = {
-  ALLOWED_SETTINGS_KEYS,
-  globToRegExp,
-  normalizeSettingsOverrides,
-  resolveOverrideSettings,
-};
+'use strict';
+
+// Pattern-based settings overrides (EVALUATION.md F11).
+//
+// `wyvrn.json` may declare a top-level `settingsOverrides` block whose
+// keys are glob patterns over dependency names. Every matching pattern
+// contributes to the resolved dep's `settings` merge; the per-dep
+// literal settings (inside `dependencies`) still win over patterns.
+//
+// Conan users know this feature as profile-side `boost*:compiler.cppstd=17`.
+// Ours lives in the manifest because that's where literal settings
+// overrides already live — one fewer concept for recipe authors.
+//
+// Pure, no I/O. Exported helpers:
+//   - normalizeSettingsOverrides: validate + sort by specificity
+//   - resolveOverrideSettings: compute the merged settings for a dep name
+
+/**
+ * Valid profile field keys that settings overrides may target.
+ * Mirrors `HASHED_PROFILE_FIELDS` in src/profile.js, but as the allow-
+ * list for OVERRIDE values (os/arch/compiler/etc.). If a pattern
+ * override tries to set something else, reject at parse time rather
+ * than silently letting it through into mergeProfile.
+ */
+const ALLOWED_SETTINGS_KEYS = new Set([
+  'os', 'arch', 'compiler', 'compiler.version', 'compiler.cppstd', 'compiler.runtime',
+]);
+
+/**
+ * Convert a glob pattern to a RegExp. Supports `*` (any chars),
+ * `?` (single char), literal everything else. No brace expansion,
+ * no negation — keep the mental model small.
+ *
+ * @param {string} glob
+ * @returns {RegExp}
+ */
+function globToRegExp(glob) {
+  const escaped = glob.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+  const pattern = escaped.replace(/\*/g, '.*').replace(/\?/g, '.');
+  return new RegExp(`^${pattern}$`);
+}
+
+/**
+ * Specificity heuristic: fewer wildcards = more specific. Ties broken
+ * by longer literal prefix, then lexical order for determinism. More
+ * specific patterns get applied LAST so they override less-specific
+ * ones in the merge.
+ *
+ * @param {string} glob
+ * @returns {[number, number, string]} sort key — lower = less specific
+ */
+function specificityKey(glob) {
+  const wildcards = (glob.match(/[*?]/g) ?? []).length;
+  const literalPrefix = glob.match(/^[^*?]*/)?.[0].length ?? 0;
+  // Invert sort order: more wildcards → lower score; more prefix → higher score.
+  return [-wildcards, literalPrefix, glob];
+}
+
+/**
+ * Validate + sort a raw `settingsOverrides` block. Returns an array of
+ * `{ pattern, regex, settings }` in application order (least-specific
+ * first). A string pattern alone (literal `"openssl"`) works too — it
+ * matches only that exact name.
+ *
+ * Throws on:
+ *  - non-object block
+ *  - non-string keys (JSON can't produce these but defensive)
+ *  - non-object values
+ *  - empty pattern strings
+ *  - unknown settings keys in a value
+ *  - non-string value leaves (settings values must be strings like
+ *    the profile itself: "dynamic", "17", "gcc")
+ *
+ * @param {unknown} block
+ * @returns {Array<{ pattern: string, regex: RegExp, settings: Record<string, string> }>}
+ */
+function normalizeSettingsOverrides(block) {
+  if (block === undefined || block === null) return [];
+  if (typeof block !== 'object' || Array.isArray(block)) {
+    throw new Error('settingsOverrides must be an object mapping globs to settings');
+  }
+
+  const entries = [];
+  for (const [rawPattern, rawValue] of Object.entries(block)) {
+    if (typeof rawPattern !== 'string' || rawPattern.length === 0) {
+      throw new Error(`settingsOverrides: pattern must be a non-empty string, got ${JSON.stringify(rawPattern)}`);
+    }
+    if (!rawValue || typeof rawValue !== 'object' || Array.isArray(rawValue)) {
+      throw new Error(`settingsOverrides["${rawPattern}"]: value must be an object of settings`);
+    }
+
+    const settings = {};
+    for (const [k, v] of Object.entries(rawValue)) {
+      if (!ALLOWED_SETTINGS_KEYS.has(k)) {
+        throw new Error(
+          `settingsOverrides["${rawPattern}"]: unknown key "${k}" — ` +
+          `allowed: ${[...ALLOWED_SETTINGS_KEYS].join(', ')}`,
+        );
+      }
+      if (typeof v !== 'string' || v.length === 0) {
+        throw new Error(
+          `settingsOverrides["${rawPattern}"].${k}: value must be a non-empty string, ` +
+          `got ${JSON.stringify(v)}`,
+        );
+      }
+      settings[k] = v;
+    }
+
+    entries.push({ pattern: rawPattern, regex: globToRegExp(rawPattern), settings });
+  }
+
+  // Sort by specificity ascending so more-specific patterns apply LAST
+  // (their settings therefore win on per-key merge).
+  entries.sort((a, b) => {
+    const ka = specificityKey(a.pattern);
+    const kb = specificityKey(b.pattern);
+    for (let i = 0; i < ka.length; i++) {
+      if (ka[i] < kb[i]) return -1;
+      if (ka[i] > kb[i]) return  1;
+    }
+    return 0;
+  });
+
+  return entries;
+}
+
+/**
+ * Merge all matching pattern overrides for `depName` into a flat
+ * settings object. Less-specific patterns apply first; more-specific
+ * patterns overlay on top. Does NOT include the literal per-dep
+ * `settings` (caller layers that on after — literal always wins).
+ *
+ * @param {string} depName
+ * @param {ReturnType<typeof normalizeSettingsOverrides>} normalized
+ * @returns {Record<string, string>}
+ */
+function resolveOverrideSettings(depName, normalized) {
+  const out = {};
+  for (const entry of normalized) {
+    if (entry.regex.test(depName)) {
+      Object.assign(out, entry.settings);
+    }
+  }
+  return out;
+}
+
+module.exports = {
+  ALLOWED_SETTINGS_KEYS,
+  globToRegExp,
+  normalizeSettingsOverrides,
+  resolveOverrideSettings,
+};

package/src/toolchain/deps.js

@@ -1,164 +1,164 @@
-'use strict';
-
-/**
- * Generate the contents of `wyvrn_deps.cmake`.
- *
- * This file is loaded via `CMAKE_PROJECT_INCLUDE` — it runs after the
- * consumer's first `project()` call, which is when CMake variables like
- * `CMAKE_CXX_COMPILER_ID`, `CMAKE_SIZEOF_VOID_P`, `CMAKE_SYSTEM_NAME`, and
- * `WIN32` / `APPLE` / `UNIX` become valid. The bundled utility scripts
- * (`variables.cmake` etc.) rely on those, so they cannot be included from
- * the toolchain body.
- *
- * @param {object}   args
- * @param {string[]} args.packageNames       Resolved dep names in topological order.
- * @param {string}   args.profileHash        16-char profile hash (for logging).
- * @returns {string} CMake file content.
- */
-function generateDepsCmake({ packageNames, profileHash }) {
-  const findPackageCalls = packageNames
-    .map((name) => `    find_package(${name} CONFIG QUIET)`)
-    .join('\n');
-
-  const resolvedList = packageNames.map((n) => `    ${n}`).join('\n');
-
-  return `# Generated by wyvrnpm — do not edit.
-# Loaded after project() via CMAKE_PROJECT_INCLUDE.
-# Profile hash: ${profileHash}
-
-if(WYVRN_DEPS_INCLUDED)
-    return()
-endif()
-set(WYVRN_DEPS_INCLUDED TRUE)
-
-# List of every package resolved by \`wyvrnpm install\`, in topological order.
-set(WYVRN_RESOLVED_PACKAGES
-${resolvedList || '    # (none)'}
-)
-
-# ── Bundled wyvrnpm CMake utilities ───────────────────────────────────────────
-# Included in the order the utility scripts expect.
-include("\${WYVRNPM_CMAKE_DIR}/variables.cmake")
-include("\${WYVRNPM_CMAKE_DIR}/options.cmake")
-include("\${WYVRNPM_CMAKE_DIR}/cpp.cmake")
-include("\${WYVRNPM_CMAKE_DIR}/functions.cmake")
-include("\${WYVRNPM_CMAKE_DIR}/macros.cmake")
-
-# ── Sanity checks (warn only — do not override the consumer's environment) ───
-if(DEFINED CMAKE_CXX_COMPILER_ID AND DEFINED WYVRN_PROFILE_COMPILER)
-    set(_wyvrn_expected_compiler_id "")
-    if(WYVRN_PROFILE_COMPILER STREQUAL "msvc")
-        set(_wyvrn_expected_compiler_id "MSVC")
-    elseif(WYVRN_PROFILE_COMPILER STREQUAL "gcc")
-        set(_wyvrn_expected_compiler_id "GNU")
-    elseif(WYVRN_PROFILE_COMPILER STREQUAL "clang")
-        set(_wyvrn_expected_compiler_id "Clang")
-    elseif(WYVRN_PROFILE_COMPILER STREQUAL "apple-clang")
-        set(_wyvrn_expected_compiler_id "AppleClang")
-    endif()
-    if(_wyvrn_expected_compiler_id AND NOT CMAKE_CXX_COMPILER_ID STREQUAL _wyvrn_expected_compiler_id)
-        message(WARNING
-            "wyvrnpm profile expects compiler '\${WYVRN_PROFILE_COMPILER}' "
-            "(CMake id '\${_wyvrn_expected_compiler_id}') but the active compiler "
-            "is '\${CMAKE_CXX_COMPILER_ID}'. Installed binaries may be ABI-incompatible."
-        )
-    endif()
-endif()
-
-if(DEFINED CMAKE_SIZEOF_VOID_P AND DEFINED WYVRN_PROFILE_ARCH)
-    if(WYVRN_PROFILE_ARCH STREQUAL "x86_64" OR WYVRN_PROFILE_ARCH STREQUAL "armv8")
-        if(NOT CMAKE_SIZEOF_VOID_P EQUAL 8)
-            message(WARNING
-                "wyvrnpm profile expects 64-bit arch '\${WYVRN_PROFILE_ARCH}' "
-                "but CMake is configuring a 32-bit build (CMAKE_SIZEOF_VOID_P=\${CMAKE_SIZEOF_VOID_P})."
-            )
-        endif()
-    elseif(WYVRN_PROFILE_ARCH STREQUAL "x86")
-        if(NOT CMAKE_SIZEOF_VOID_P EQUAL 4)
-            message(WARNING
-                "wyvrnpm profile expects 32-bit arch 'x86' "
-                "but CMake is configuring a 64-bit build (CMAKE_SIZEOF_VOID_P=\${CMAKE_SIZEOF_VOID_P})."
-            )
-        endif()
-    endif()
-endif()
-
-# ── wyvrnpm_find_dependencies() ───────────────────────────────────────────────
-# One-shot helper: resolves every package that wyvrnpm installed.
-# Packages that don't ship a CMake config are silently skipped (CONFIG QUIET).
-function(wyvrnpm_find_dependencies)
-${findPackageCalls || '    # (no dependencies)'}
-
-    # Post-find aliasing: ensure every resolved package has a wyvrn::<name>
-    # target, creating an INTERFACE alias when the package exports only
-    # <name>::<name>. Skipped when wyvrn::<name> already exists.
-    foreach(_wyvrn_pkg IN LISTS WYVRN_RESOLVED_PACKAGES)
-        if(TARGET wyvrn::\${_wyvrn_pkg})
-            # Already provided by the package's own CMake config.
-        elseif(TARGET \${_wyvrn_pkg}::\${_wyvrn_pkg})
-            add_library(wyvrn::\${_wyvrn_pkg} INTERFACE IMPORTED)
-            set_target_properties(wyvrn::\${_wyvrn_pkg} PROPERTIES
-                INTERFACE_LINK_LIBRARIES \${_wyvrn_pkg}::\${_wyvrn_pkg}
-            )
-        endif()
-    endforeach()
-endfunction()
-
-# ── wyvrnpm_enable_runtime_dll_copy(target) ───────────────────────────────────
-# Adds a POST_BUILD command that copies every runtime DLL the target depends on
-# (transitively, via \$<TARGET_RUNTIME_DLLS:...>) next to the target's own
-# binary — so consumers can run the executable straight from the build dir
-# without \`PATH\` tinkering. No-op on non-Windows platforms and on non-
-# executable targets.
-#
-# Respects the per-target opt-out property WYVRN_COPY_RUNTIME_DLLS OFF.
-# Requires CMake ≥ 3.21 (for TARGET_RUNTIME_DLLS).
-function(wyvrnpm_enable_runtime_dll_copy target)
-    if(NOT WIN32)
-        return()
-    endif()
-    if(NOT TARGET \${target})
-        message(WARNING "wyvrnpm_enable_runtime_dll_copy: target '\${target}' does not exist")
-        return()
-    endif()
-    get_target_property(_wyvrn_type \${target} TYPE)
-    if(NOT _wyvrn_type STREQUAL "EXECUTABLE")
-        return()
-    endif()
-    get_target_property(_wyvrn_optout \${target} WYVRN_COPY_RUNTIME_DLLS)
-    if(_wyvrn_optout STREQUAL "OFF" OR _wyvrn_optout STREQUAL "FALSE")
-        return()
-    endif()
-    add_custom_command(TARGET \${target} POST_BUILD
-        COMMAND \${CMAKE_COMMAND} -E copy_if_different
-                "\$<TARGET_RUNTIME_DLLS:\${target}>"
-                "\$<TARGET_FILE_DIR:\${target}>"
-        COMMAND_EXPAND_LISTS
-        VERBATIM
-    )
-endfunction()
-
-# ── wyvrnpm_finalize_targets() ────────────────────────────────────────────────
-# Discovers all executable targets in the calling directory (top-level only,
-# not recursive) and wires each one up for runtime-DLL copy. Call this at the
-# end of the consumer's top-level CMakeLists.txt, AFTER all add_executable()
-# calls, so every target is visible.
-#
-# Scope: uses the BUILDSYSTEM_TARGETS directory property of the calling
-# directory. For multi-subdirectory projects where executables are added from
-# subdirectories, consumers should either:
-#   (a) call wyvrnpm_enable_runtime_dll_copy(<tgt>) explicitly for each exe, or
-#   (b) call wyvrnpm_finalize_targets() from each subdirectory.
-function(wyvrnpm_finalize_targets)
-    get_property(_wyvrn_targets DIRECTORY PROPERTY BUILDSYSTEM_TARGETS)
-    foreach(_wyvrn_t IN LISTS _wyvrn_targets)
-        get_target_property(_wyvrn_type \${_wyvrn_t} TYPE)
-        if(_wyvrn_type STREQUAL "EXECUTABLE")
-            wyvrnpm_enable_runtime_dll_copy(\${_wyvrn_t})
-        endif()
-    endforeach()
-endfunction()
-`;
-}
-
-module.exports = { generateDepsCmake };
+'use strict';
+
+/**
+ * Generate the contents of `wyvrn_deps.cmake`.
+ *
+ * This file is loaded via `CMAKE_PROJECT_INCLUDE` — it runs after the
+ * consumer's first `project()` call, which is when CMake variables like
+ * `CMAKE_CXX_COMPILER_ID`, `CMAKE_SIZEOF_VOID_P`, `CMAKE_SYSTEM_NAME`, and
+ * `WIN32` / `APPLE` / `UNIX` become valid. The bundled utility scripts
+ * (`variables.cmake` etc.) rely on those, so they cannot be included from
+ * the toolchain body.
+ *
+ * @param {object}   args
+ * @param {string[]} args.packageNames       Resolved dep names in topological order.
+ * @param {string}   args.profileHash        16-char profile hash (for logging).
+ * @returns {string} CMake file content.
+ */
+function generateDepsCmake({ packageNames, profileHash }) {
+  const findPackageCalls = packageNames
+    .map((name) => `    find_package(${name} CONFIG QUIET)`)
+    .join('\n');
+
+  const resolvedList = packageNames.map((n) => `    ${n}`).join('\n');
+
+  return `# Generated by wyvrnpm — do not edit.
+# Loaded after project() via CMAKE_PROJECT_INCLUDE.
+# Profile hash: ${profileHash}
+
+if(WYVRN_DEPS_INCLUDED)
+    return()
+endif()
+set(WYVRN_DEPS_INCLUDED TRUE)
+
+# List of every package resolved by \`wyvrnpm install\`, in topological order.
+set(WYVRN_RESOLVED_PACKAGES
+${resolvedList || '    # (none)'}
+)
+
+# ── Bundled wyvrnpm CMake utilities ───────────────────────────────────────────
+# Included in the order the utility scripts expect.
+include("\${WYVRNPM_CMAKE_DIR}/variables.cmake")
+include("\${WYVRNPM_CMAKE_DIR}/options.cmake")
+include("\${WYVRNPM_CMAKE_DIR}/cpp.cmake")
+include("\${WYVRNPM_CMAKE_DIR}/functions.cmake")
+include("\${WYVRNPM_CMAKE_DIR}/macros.cmake")
+
+# ── Sanity checks (warn only — do not override the consumer's environment) ───
+if(DEFINED CMAKE_CXX_COMPILER_ID AND DEFINED WYVRN_PROFILE_COMPILER)
+    set(_wyvrn_expected_compiler_id "")
+    if(WYVRN_PROFILE_COMPILER STREQUAL "msvc")
+        set(_wyvrn_expected_compiler_id "MSVC")
+    elseif(WYVRN_PROFILE_COMPILER STREQUAL "gcc")
+        set(_wyvrn_expected_compiler_id "GNU")
+    elseif(WYVRN_PROFILE_COMPILER STREQUAL "clang")
+        set(_wyvrn_expected_compiler_id "Clang")
+    elseif(WYVRN_PROFILE_COMPILER STREQUAL "apple-clang")
+        set(_wyvrn_expected_compiler_id "AppleClang")
+    endif()
+    if(_wyvrn_expected_compiler_id AND NOT CMAKE_CXX_COMPILER_ID STREQUAL _wyvrn_expected_compiler_id)
+        message(WARNING
+            "wyvrnpm profile expects compiler '\${WYVRN_PROFILE_COMPILER}' "
+            "(CMake id '\${_wyvrn_expected_compiler_id}') but the active compiler "
+            "is '\${CMAKE_CXX_COMPILER_ID}'. Installed binaries may be ABI-incompatible."
+        )
+    endif()
+endif()
+
+if(DEFINED CMAKE_SIZEOF_VOID_P AND DEFINED WYVRN_PROFILE_ARCH)
+    if(WYVRN_PROFILE_ARCH STREQUAL "x86_64" OR WYVRN_PROFILE_ARCH STREQUAL "armv8")
+        if(NOT CMAKE_SIZEOF_VOID_P EQUAL 8)
+            message(WARNING
+                "wyvrnpm profile expects 64-bit arch '\${WYVRN_PROFILE_ARCH}' "
+                "but CMake is configuring a 32-bit build (CMAKE_SIZEOF_VOID_P=\${CMAKE_SIZEOF_VOID_P})."
+            )
+        endif()
+    elseif(WYVRN_PROFILE_ARCH STREQUAL "x86")
+        if(NOT CMAKE_SIZEOF_VOID_P EQUAL 4)
+            message(WARNING
+                "wyvrnpm profile expects 32-bit arch 'x86' "
+                "but CMake is configuring a 64-bit build (CMAKE_SIZEOF_VOID_P=\${CMAKE_SIZEOF_VOID_P})."
+            )
+        endif()
+    endif()
+endif()
+
+# ── wyvrnpm_find_dependencies() ───────────────────────────────────────────────
+# One-shot helper: resolves every package that wyvrnpm installed.
+# Packages that don't ship a CMake config are silently skipped (CONFIG QUIET).
+function(wyvrnpm_find_dependencies)
+${findPackageCalls || '    # (no dependencies)'}
+
+    # Post-find aliasing: ensure every resolved package has a wyvrn::<name>
+    # target, creating an INTERFACE alias when the package exports only
+    # <name>::<name>. Skipped when wyvrn::<name> already exists.
+    foreach(_wyvrn_pkg IN LISTS WYVRN_RESOLVED_PACKAGES)
+        if(TARGET wyvrn::\${_wyvrn_pkg})
+            # Already provided by the package's own CMake config.
+        elseif(TARGET \${_wyvrn_pkg}::\${_wyvrn_pkg})
+            add_library(wyvrn::\${_wyvrn_pkg} INTERFACE IMPORTED)
+            set_target_properties(wyvrn::\${_wyvrn_pkg} PROPERTIES
+                INTERFACE_LINK_LIBRARIES \${_wyvrn_pkg}::\${_wyvrn_pkg}
+            )
+        endif()
+    endforeach()
+endfunction()
+
+# ── wyvrnpm_enable_runtime_dll_copy(target) ───────────────────────────────────
+# Adds a POST_BUILD command that copies every runtime DLL the target depends on
+# (transitively, via \$<TARGET_RUNTIME_DLLS:...>) next to the target's own
+# binary — so consumers can run the executable straight from the build dir
+# without \`PATH\` tinkering. No-op on non-Windows platforms and on non-
+# executable targets.
+#
+# Respects the per-target opt-out property WYVRN_COPY_RUNTIME_DLLS OFF.
+# Requires CMake ≥ 3.21 (for TARGET_RUNTIME_DLLS).
+function(wyvrnpm_enable_runtime_dll_copy target)
+    if(NOT WIN32)
+        return()
+    endif()
+    if(NOT TARGET \${target})
+        message(WARNING "wyvrnpm_enable_runtime_dll_copy: target '\${target}' does not exist")
+        return()
+    endif()
+    get_target_property(_wyvrn_type \${target} TYPE)
+    if(NOT _wyvrn_type STREQUAL "EXECUTABLE")
+        return()
+    endif()
+    get_target_property(_wyvrn_optout \${target} WYVRN_COPY_RUNTIME_DLLS)
+    if(_wyvrn_optout STREQUAL "OFF" OR _wyvrn_optout STREQUAL "FALSE")
+        return()
+    endif()
+    add_custom_command(TARGET \${target} POST_BUILD
+        COMMAND \${CMAKE_COMMAND} -E copy_if_different
+                "\$<TARGET_RUNTIME_DLLS:\${target}>"
+                "\$<TARGET_FILE_DIR:\${target}>"
+        COMMAND_EXPAND_LISTS
+        VERBATIM
+    )
+endfunction()
+
+# ── wyvrnpm_finalize_targets() ────────────────────────────────────────────────
+# Discovers all executable targets in the calling directory (top-level only,
+# not recursive) and wires each one up for runtime-DLL copy. Call this at the
+# end of the consumer's top-level CMakeLists.txt, AFTER all add_executable()
+# calls, so every target is visible.
+#
+# Scope: uses the BUILDSYSTEM_TARGETS directory property of the calling
+# directory. For multi-subdirectory projects where executables are added from
+# subdirectories, consumers should either:
+#   (a) call wyvrnpm_enable_runtime_dll_copy(<tgt>) explicitly for each exe, or
+#   (b) call wyvrnpm_finalize_targets() from each subdirectory.
+function(wyvrnpm_finalize_targets)
+    get_property(_wyvrn_targets DIRECTORY PROPERTY BUILDSYSTEM_TARGETS)
+    foreach(_wyvrn_t IN LISTS _wyvrn_targets)
+        get_target_property(_wyvrn_type \${_wyvrn_t} TYPE)
+        if(_wyvrn_type STREQUAL "EXECUTABLE")
+            wyvrnpm_enable_runtime_dll_copy(\${_wyvrn_t})
+        endif()
+    endforeach()
+endfunction()
+`;
+}
+
+module.exports = { generateDepsCmake };