docs: dynamically resolve version from git tag

Replace hardcoded version in nav badge and installation examples with
dynamic resolution from the latest git tag. Remove the migration guide
as it has limited value without breaking changes.

Author: driessamyn

docs/.vitepress/config.ts

@@ -1,9 +1,32 @@
 import { defineConfig } from 'vitepress'
+import { execSync } from 'child_process'
+
+function getKapperVersion(): string {
+  if (process.env.KAPPER_VERSION) {
+    return process.env.KAPPER_VERSION
+  }
+  try {
+    return execSync('git tag --sort=-v:refname | head -1', { encoding: 'utf-8' }).trim()
+  } catch {
+    return 'dev'
+  }
+}
+
+const kapperVersion = getKapperVersion()
 
 export default defineConfig({
   title: 'Kapper',
   description: 'A lightweight, Dapper-inspired ORM for Kotlin and the JVM',
   base: '/kapper/',
+  markdown: {
+    config: (md) => {
+      const defaultRender = md.render.bind(md)
+      md.render = (src: string, env: any) => {
+        src = src.replaceAll('%kapper_version%', kapperVersion)
+        return defaultRender(src, env)
+      }
+    }
+  },
   ignoreDeadLinks: [
     // Ignore all API documentation links (generated by dokka)
     (url, context) => {
@@ -31,11 +54,10 @@ export default defineConfig({
       { text: 'Performance', link: '/performance/' },
       { text: 'API Reference', link: '/api/' },
       { text: 'Blog', link: '/blog/' },
-      { 
-        text: 'v1.6.1', 
+      {
+        text: `v${kapperVersion}`,
         items: [
-          { text: 'Changelog', link: '/changelog' },
-          { text: 'Migration Guide', link: '/guide/migration' }
+          { text: 'Changelog', link: '/changelog' }
         ]
       }
     ],

docs/guide/installation.md

@@ -6,15 +6,15 @@ Add Kapper to your `build.gradle.kts`:
 
 ```kotlin
 dependencies {
-    implementation("net.samyn:kapper:1.6.1")
+    implementation("net.samyn:kapper:%kapper_version%")
 }
 ```
 
 For coroutine support, use:
 
 ```kotlin
 dependencies {
-    implementation("net.samyn:kapper-coroutines:1.6.1")
+    implementation("net.samyn:kapper-coroutines:%kapper_version%")
 }
 ```
 
@@ -24,7 +24,7 @@ Add Kapper to your `build.gradle`:
 
 ```groovy
 dependencies {
-    implementation 'net.samyn:kapper:1.6.1'
+    implementation 'net.samyn:kapper:%kapper_version%'
 }
 ```
 
@@ -36,7 +36,7 @@ Add the following dependency to your `pom.xml`:
 <dependency>
     <groupId>net.samyn</groupId>
     <artifactId>kapper</artifactId>
-    <version>1.6.1</version>
+    <version>%kapper_version%</version>
 </dependency>
 ```