wyvrnpm 2.0.2 → 2.1.0

package/src/toolchain/presets.js

@@ -0,0 +1,191 @@
+'use strict';
+
+const fs   = require('fs');
+const path = require('path');
+
+const VENDOR_KEY = 'wyvrnpm/generated';
+const SCHEMA_VERSION = 3;  // requires CMake ≥ 3.21
+
+/**
+ * Safely parse a JSON file; returns null on any error (missing, malformed, …).
+ * @param {string} p
+ * @returns {object|null}
+ */
+function safeReadJson(p) {
+  try {
+    return JSON.parse(fs.readFileSync(p, 'utf8'));
+  } catch {
+    return null;
+  }
+}
+
+/**
+ * True if the parsed presets object was produced by wyvrnpm (i.e. carries our
+ * vendor marker). Hand-edited or user-owned files return false.
+ *
+ * @param {object|null} presets
+ * @returns {boolean}
+ */
+function isWyvrnGenerated(presets) {
+  return !!presets && typeof presets.vendor === 'object' && !!presets.vendor[VENDOR_KEY];
+}
+
+/**
+ * Build the configure preset object for the active profile.
+ *
+ * @param {object} args
+ * @param {string} args.profileName
+ * @param {string} args.profileHash
+ * @param {string} args.toolchainRelPath   Relative from project root, CMake-style
+ *                                         forward slashes.
+ */
+function buildConfigurePreset({ profileName, profileHash, toolchainRelPath }) {
+  return {
+    name:         `wyvrn-${profileName}`,
+    displayName:  `wyvrnpm (${profileName})`,
+    description:  `Generated by wyvrnpm install — profile hash ${profileHash}`,
+    binaryDir:    `\${sourceDir}/build/wyvrn-${profileName}`,
+    cacheVariables: {
+      CMAKE_TOOLCHAIN_FILE: `\${sourceDir}/${toolchainRelPath}`,
+    },
+  };
+}
+
+/**
+ * Two build presets per configure preset: Debug and Release.
+ *
+ * @param {string} profileName
+ * @returns {Array<object>}
+ */
+function buildBuildPresets(profileName) {
+  const config = `wyvrn-${profileName}`;
+  return [
+    {
+      name:            `${config}-debug`,
+      displayName:     `wyvrn ${profileName} (Debug)`,
+      configurePreset: config,
+      configuration:   'Debug',
+    },
+    {
+      name:            `${config}-release`,
+      displayName:     `wyvrn ${profileName} (Release)`,
+      configurePreset: config,
+      configuration:   'Release',
+    },
+  ];
+}
+
+/**
+ * Build a fresh presets file from scratch (no prior content to merge).
+ */
+function buildFreshPresetsFile({ profileName, profileHash, toolchainRelPath }) {
+  return {
+    version: SCHEMA_VERSION,
+    vendor: {
+      [VENDOR_KEY]: {
+        profileName,
+        profileHash,
+        generatedAt: new Date().toISOString(),
+      },
+    },
+    configurePresets: [buildConfigurePreset({ profileName, profileHash, toolchainRelPath })],
+    buildPresets:     buildBuildPresets(profileName),
+  };
+}
+
+/**
+ * Merge the current profile's presets into an existing wyvrnpm-generated
+ * file. Presets with matching `name` are replaced; others are preserved so
+ * `wyvrnpm install --profile release` followed by `wyvrnpm install --profile
+ * debug` leaves both profiles available in the file.
+ *
+ * @param {object} existing
+ * @param {object} args  forwarded to the preset builders
+ * @returns {object}
+ */
+function mergeIntoExisting(existing, { profileName, profileHash, toolchainRelPath }) {
+  const newConfigure = buildConfigurePreset({ profileName, profileHash, toolchainRelPath });
+  const newBuilds    = buildBuildPresets(profileName);
+  const newConfigureNames = new Set([newConfigure.name]);
+  const newBuildNames     = new Set(newBuilds.map((b) => b.name));
+
+  const configurePresets = (existing.configurePresets ?? []).filter((p) => !newConfigureNames.has(p.name));
+  configurePresets.push(newConfigure);
+
+  const buildPresets = (existing.buildPresets ?? []).filter((p) => !newBuildNames.has(p.name));
+  buildPresets.push(...newBuilds);
+
+  return {
+    ...existing,
+    version: existing.version ?? SCHEMA_VERSION,
+    vendor: {
+      ...(existing.vendor ?? {}),
+      [VENDOR_KEY]: {
+        profileName,
+        profileHash,
+        generatedAt: new Date().toISOString(),
+      },
+    },
+    configurePresets,
+    buildPresets,
+  };
+}
+
+/**
+ * Write a CMakePresets.json (or CMakeUserPresets.json, as fallback) under
+ * `projectRoot`. Never overwrites a user-owned file.
+ *
+ * Resolution order:
+ *   1. CMakePresets.json
+ *      - Does not exist     → create it.
+ *      - Exists, wyvrn-gen  → merge into it.
+ *      - Exists, user-owned → leave alone, fall through.
+ *   2. CMakeUserPresets.json
+ *      - Does not exist     → create it.
+ *      - Exists, wyvrn-gen  → merge into it.
+ *      - Exists, user-owned → skip (action: "skipped").
+ *
+ * @param {object} args
+ * @param {string} args.projectRoot       Directory containing top-level CMakeLists.txt.
+ * @param {string} args.profileName
+ * @param {string} args.profileHash
+ * @param {string} args.toolchainRelPath  CMake-style forward slashes, relative to projectRoot.
+ * @returns {{ path: string|null, action: 'created'|'updated'|'skipped', isUser: boolean }}
+ */
+function generateCMakePresets({ projectRoot, profileName, profileHash, toolchainRelPath }) {
+  const candidates = [
+    { filePath: path.join(projectRoot, 'CMakePresets.json'),     isUser: false },
+    { filePath: path.join(projectRoot, 'CMakeUserPresets.json'), isUser: true  },
+  ];
+
+  for (const { filePath, isUser } of candidates) {
+    if (!fs.existsSync(filePath)) {
+      const content = buildFreshPresetsFile({ profileName, profileHash, toolchainRelPath });
+      fs.writeFileSync(filePath, JSON.stringify(content, null, 2) + '\n', 'utf8');
+      return { path: filePath, action: 'created', isUser };
+    }
+
+    const existing = safeReadJson(filePath);
+    if (isWyvrnGenerated(existing)) {
+      const merged = mergeIntoExisting(existing, { profileName, profileHash, toolchainRelPath });
+      fs.writeFileSync(filePath, JSON.stringify(merged, null, 2) + '\n', 'utf8');
+      return { path: filePath, action: 'updated', isUser };
+    }
+
+    // User-owned — do not touch, try next candidate.
+  }
+
+  return { path: null, action: 'skipped', isUser: false };
+}
+
+module.exports = {
+  generateCMakePresets,
+  // Exported for tests
+  isWyvrnGenerated,
+  buildConfigurePreset,
+  buildBuildPresets,
+  buildFreshPresetsFile,
+  mergeIntoExisting,
+  VENDOR_KEY,
+  SCHEMA_VERSION,
+};

package/src/toolchain/template.cmake

@@ -0,0 +1,66 @@
+# Generated by wyvrnpm — do not edit.
+# Regenerated on every `wyvrnpm install`.
+#
+# Usage:
+#   cmake -B build -S . -DCMAKE_TOOLCHAIN_FILE=wyvrn_internal/wyvrn_toolchain.cmake
+#
+# Profile : {{PROFILE_NAME}}  [{{PROFILE_HASH}}]
+# Generated: {{GENERATED_AT}}
+
+if(WYVRNPM_TOOLCHAIN_INCLUDED)
+    return()
+endif()
+set(WYVRNPM_TOOLCHAIN_INCLUDED TRUE)
+
+# ── Active build profile (copied verbatim from wyvrn_profile.json) ────────────
+set(WYVRN_PROFILE_NAME             "{{PROFILE_NAME}}")
+set(WYVRN_PROFILE_HASH             "{{PROFILE_HASH}}")
+set(WYVRN_PROFILE_OS               "{{PROFILE_OS}}")
+set(WYVRN_PROFILE_ARCH             "{{PROFILE_ARCH}}")
+set(WYVRN_PROFILE_COMPILER         "{{PROFILE_COMPILER}}")
+set(WYVRN_PROFILE_COMPILER_VERSION "{{PROFILE_COMPILER_VERSION}}")
+set(WYVRN_PROFILE_CPPSTD           "{{PROFILE_CPPSTD}}")
+set(WYVRN_PROFILE_RUNTIME          "{{PROFILE_RUNTIME}}")
+
+# ── Path to wyvrnpm's bundled CMake utilities (variables.cmake, etc.) ─────────
+# Resolved at generation time so the toolchain works regardless of whether
+# wyvrnpm was installed globally, locally, or via npx.
+set(WYVRNPM_CMAKE_DIR "{{WYVRNPM_CMAKE_DIR}}")
+
+# ── C++ standard ──────────────────────────────────────────────────────────────
+if(NOT DEFINED CMAKE_CXX_STANDARD)
+    set(CMAKE_CXX_STANDARD {{PROFILE_CPPSTD}})
+    set(CMAKE_CXX_STANDARD_REQUIRED ON)
+    set(CMAKE_CXX_EXTENSIONS OFF)
+endif()
+
+# ── MSVC runtime library ──────────────────────────────────────────────────────
+# Only meaningful when the actual compiler is MSVC. CMake ignores this on other
+# compilers, so setting it unconditionally is safe.
+if("${WYVRN_PROFILE_RUNTIME}" STREQUAL "dynamic")
+    set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>DLL")
+elseif("${WYVRN_PROFILE_RUNTIME}" STREQUAL "static")
+    set(CMAKE_MSVC_RUNTIME_LIBRARY "MultiThreaded$<$<CONFIG:Debug>:Debug>")
+endif()
+
+# ── Position-independent code (sensible default for mixed static/shared) ──────
+if(NOT DEFINED CMAKE_POSITION_INDEPENDENT_CODE)
+    set(CMAKE_POSITION_INDEPENDENT_CODE ON)
+endif()
+
+# ── CMAKE_PREFIX_PATH: so find_package(<dep> CONFIG) finds installed deps ─────
+list(PREPEND CMAKE_PREFIX_PATH
+{{PREFIX_PATH_ENTRIES}}
+)
+
+# ── CMAKE_MODULE_PATH: so include(<script>) finds bundled *.cmake files ───────
+list(PREPEND CMAKE_MODULE_PATH
+    "${WYVRNPM_CMAKE_DIR}"
+)
+
+# ── Post-project() hook ───────────────────────────────────────────────────────
+# CMAKE_PROJECT_INCLUDE runs after the first project() call, which is when
+# CMAKE_SYSTEM_NAME / CMAKE_CXX_COMPILER_ID / CMAKE_SIZEOF_VOID_P become valid.
+# The bundled utilities (variables.cmake etc.) rely on those — so they must be
+# included from here, not from the toolchain body above.
+set(CMAKE_PROJECT_INCLUDE "${CMAKE_CURRENT_LIST_DIR}/wyvrn_deps.cmake")