CheatEngineSdk.props

<Project>
  <!-- Optional parent-workspace settings allow an identical graph during recursive restore and build.
       A standalone Client checkout has no such file and keeps the NuGet graph below. -->
  <Import Project="$(MSBuildThisFileDirectory)../../CheatEngine.Source.props"
          Condition="'$(CheatEngineImportSourceSettings)' != 'false' and Exists('$(MSBuildThisFileDirectory)../../CheatEngine.Source.props')"/>
  <!--
    The single reviewed source of the CheatEngine.SDK package this Client consumes (audit ADR-10, A21-01).

    Directory.Packages.props imports this file, so every project sees these values before its own body, including the
    Coexistence fixtures that turn Central Package Management off. Every MSBuild usage derives from them:
    - the central PackageVersion of CheatEngine.SDK (Directory.Packages.props);
    - the VersionOverride range of the three SDK-facing libraries (Abstractions, Core, Hosting), which becomes the
      dependency range of their packages;
    - the default SDK version of the Coexistence fixtures;
    - the SDK version stamped into the packed ceplugin template;
    - the CHEATENGINECLIENT9016/9017 guards in Directory.Build.targets.
    The reviewed identity of the pinned package (content hash, signed-file hashes, bridge) is hardcoded next to its
    consumers: tests/CheatEngine.Client.Tests/Packaging/PackagedClientFeedFixture.cs (PinnedSdkIdentity) and
    tests/CheatEngine.Client.Repository.Tests/LockFiles/LockFileTests.cs (ConsumedSdkContentHash). The three install
    guides state the same identity: src/CheatEngine.Client/README.md, templates/CheatEngine.Client.Templates/README.md
    and templates/CheatEngine.Client.Templates/content/CheatEngine.Plugin/README.md. Tests keep this file, those
    literals, the lock files and the documentation in agreement.

    The properties are assigned unconditionally: an environment variable cannot change the pin, only an explicit
    -p: global property can.

    Bump procedure (no script; every step lands in one pull request): update CheatEngineSdkVersion here; update the
    reviewed identity literals named above to the new package's hashes, and the NuGet content hash, bridge SHA-256 and
    source commit that the three install guides state (the host executable and runtime configuration hashes name the
    Cheat Engine host, not the SDK); regenerate every packages.lock.json with a force-evaluate restore of each project
    (Coexistence fixtures first, one by one, never the solution with a force-evaluate restore: that once rewrote their
    legacy lock files with CentralTransitive entries and broke every locked restore); update the SDK version named in
    prose (SdkPinTests.ProseMentionsOfTheConsumedSdkEqualThePin lists the files). Never edit the version by hand without
    the identity literals, and never move to another major in a dependency bump.

    Major migration (a deliberate maintainer decision, never a dependency bump): the bump procedure above, plus
    - CheatEngineSdkUpperBound and _CheatEngineClientSupportedSdkMajor here, and _CheatEngineClientSdkUpperMajor in
      libs/CheatEngine.Client.Hosting/buildTransitive/CheatEngine.Client.Hosting.targets (the CECLIENT017 guard);
    - the CheatEngine.SDK default of the template content project and its "Keep CheatEngine.SDK on N.x" comment
      (templates/CheatEngine.Client.Templates/content/CheatEngine.Plugin/CheatEngine.Plugin.csproj);
    - the identity literals of PackagedClientFeedFixture.PinnedSdkIdentity and LockFileTests, and the sample identity
      and version matrix of tests/CheatEngine.Client.Core.Tests/Domains/RuntimeClientTests.cs and
      tests/CheatEngine.Client.Core.Tests/Infrastructure/ConsumedSdkIdentityTests.cs; the retired literals join
      SdkPinTests.RetiredSdkIdentityLiteralsAppearNowhere;
    - the NuGet content hash, bridge SHA-256 and source commit lines of the three install guides;
    - the CheatEngine.SDK major ignored by .github/dependabot.yml (DependabotConfigurationTests) and the Client, SDK and
      content hash placeholders of the .github/ISSUE_TEMPLATE forms;
    - the capability reasons of libs/CheatEngine.Client.Core/Domains/RuntimeClient.cs and every sentence that states
      what the consumed SDK provides: rewrite what it means for the new major, not only its number;
    - the lock file regeneration above, with the .NET SDK CLI that global.json pins, project by project;
    - after a .NET SDK bump, a check that the internal .NET SDK target _GetProjectReferenceVersions still exists and
      still produces _ProjectReferencesWithVersions items with ProjectVersion metadata: they carry the dependency
      versions of project references in packed nuspecs, CheatEngineClientPinInterClientDependencies
      (Directory.Build.targets) makes them exact, and an internal target can change without notice
      (PackageConsumptionSmokeTests.InterClientDependenciesRequireTheExactCoPackedVersion fails if it does).
  -->
  <PropertyGroup Label="Consumed CheatEngine.SDK">
    <!-- Optional SDK checkout. Empty keeps the reviewed NuGet package graph unchanged. -->
    <CheatEngineSdkSourceMode Condition="'$(CheatEngineSdkSourceRoot)' != ''">true</CheatEngineSdkSourceMode>
    <_CheatEngineSdkSourceDirectory Condition="'$(CheatEngineSdkSourceMode)' == 'true'">$([MSBuild]::EnsureTrailingSlash($([System.IO.Path]::GetFullPath('$(CheatEngineSdkSourceRoot)'))))</_CheatEngineSdkSourceDirectory>
    <CheatEngineSdkEngineProject Condition="'$(CheatEngineSdkSourceMode)' == 'true'">$(_CheatEngineSdkSourceDirectory)libs/CheatEngine.SDK.Engine/CheatEngine.SDK.Engine.csproj</CheatEngineSdkEngineProject>
    <CheatEngineSdkHostingProject Condition="'$(CheatEngineSdkSourceMode)' == 'true'">$(_CheatEngineSdkSourceDirectory)libs/CheatEngine.SDK.Hosting/CheatEngine.SDK.Hosting.csproj</CheatEngineSdkHostingProject>
    <NuGetLockFilePath Condition="'$(CheatEngineSourceLockFileDirectory)' != ''">$(CheatEngineSourceLockFileDirectory)/$(MSBuildProjectName).lock.json</NuGetLockFilePath>
    <CheatEngineSdkVersion>2.0.0</CheatEngineSdkVersion>
    <CheatEngineSdkUpperBound>3.0.0</CheatEngineSdkUpperBound>
    <CheatEngineSdkVersionRange>[$(CheatEngineSdkVersion),$(CheatEngineSdkUpperBound))</CheatEngineSdkVersionRange>
    <!-- The one SDK major this Client supports. Changing it is a major migration (see above), not a dependency bump. -->
    <_CheatEngineClientSupportedSdkMajor>2</_CheatEngineClientSupportedSdkMajor>
  </PropertyGroup>
  <Target Name="CheatEngineClientValidateSdkSourceRoot" BeforeTargets="CollectPackageReferences"
          Condition="'$(CheatEngineSdkSourceMode)' == 'true'">
    <Error Condition="!Exists('$(CheatEngineSdkEngineProject)') or !Exists('$(CheatEngineSdkHostingProject)')" Code="CHEATENGINECLIENT9051"
           Text="CheatEngineSdkSourceRoot must name an SDK checkout containing the Engine and Hosting runtime projects."/>
  </Target>
</Project>