From 12c38630f7b54cccfa677d908675da8c43178246 Mon Sep 17 00:00:00 2001
From: John Leider <john@vuetifyjs.com>
Date: Tue, 2 Jun 2026 22:11:47 -0500
Subject: [PATCH] docs: alias prerelease versions in the maturity matrix
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Render short release labels (alpha.N, beta.0) in the roadmap maturity
matrix via a display-only alias map (RELEASE_ALIASES + releaseAlias). The
since field stays canonical semver, so the /releases deep-link and
downstream semver consumers keep working — only the rendered label changes.

Also backfill since: "1.0.0-beta.0" for createDataGrid, useTooltip, and
Tooltip; they shipped in v1.0.0-beta.0 but the release commit left their
since as null.
---
 .../docs/src/components/docs/DocsMaturity.vue |  5 +++--
 apps/docs/src/constants/releases.ts           | 21 +++++++++++++++++++
 packages/0/src/maturity.json                  |  6 +++---
 3 files changed, 27 insertions(+), 5 deletions(-)
 create mode 100644 apps/docs/src/constants/releases.ts

diff --git a/apps/docs/src/components/docs/DocsMaturity.vue b/apps/docs/src/components/docs/DocsMaturity.vue
index 53c5bb7b8..40b3345e7 100644
--- a/apps/docs/src/components/docs/DocsMaturity.vue
+++ b/apps/docs/src/components/docs/DocsMaturity.vue
@@ -3,6 +3,7 @@
   import { createDataTable, createGroup, createSingle } from '@vuetify/v0'
 
   import maturityData from '#v0/maturity.json'
+  import { releaseAlias } from '@/constants/releases'
 
   // Utilities
   import { toRef, watch } from 'vue'
@@ -345,7 +346,7 @@
                 >{{ item.type }}</span>
 
                 <span v-if="item.since" class="text-[10px] text-on-surface-variant font-mono">
-                  v{{ item.since }}
+                  {{ releaseAlias(item.since) }}
                 </span>
               </div>
             </div>
@@ -526,7 +527,7 @@
                   class="text-primary no-underline hover:underline whitespace-nowrap"
                   :href="`/releases/?version=v${item.since}`"
                   target="_blank"
-                >v{{ item.since }} ↗</a>
+                >{{ releaseAlias(item.since) }} ↗</a>
 
                 <span v-else class="text-on-surface-variant/50">—</span>
               </td>
diff --git a/apps/docs/src/constants/releases.ts b/apps/docs/src/constants/releases.ts
new file mode 100644
index 000000000..b3d8e1486
--- /dev/null
+++ b/apps/docs/src/constants/releases.ts
@@ -0,0 +1,21 @@
+/**
+ * Maps a canonical release version (the maturity `since` value, no `v` prefix)
+ * to a short display alias. The full version still drives the release deep-link,
+ * so only the rendered label changes — not the underlying data.
+ */
+export const RELEASE_ALIASES: Record<string, string> = {
+  '1.0.0-alpha.0': 'alpha.0',
+  '1.0.0-alpha.1': 'alpha.1',
+  '1.0.0-alpha.2': 'alpha.2',
+  '1.0.0-alpha.3': 'alpha.3',
+  '1.0.0-alpha.4': 'alpha.4',
+  '1.0.0-alpha.5': 'alpha.5',
+  '1.0.0-beta.0': 'beta.0',
+}
+
+/** Display label for a release version: its alias, or `v{version}` when unmapped. */
+export function releaseAlias (version: string | undefined): string {
+  if (!version) return ''
+
+  return RELEASE_ALIASES[version] ?? `v${version}`
+}
diff --git a/packages/0/src/maturity.json b/packages/0/src/maturity.json
index 1950f11bd..051587602 100644
--- a/packages/0/src/maturity.json
+++ b/packages/0/src/maturity.json
@@ -108,7 +108,7 @@
     },
     "createDataGrid": {
       "level": "preview",
-      "since": null,
+      "since": "1.0.0-beta.0",
       "category": "data"
     },
     "createDataTable": {
@@ -208,7 +208,7 @@
     },
     "useTooltip": {
       "level": "preview",
-      "since": null,
+      "since": "1.0.0-beta.0",
       "category": "plugins"
     },
     "useClickOutside": {
@@ -521,7 +521,7 @@
     },
     "Tooltip": {
       "level": "preview",
-      "since": null,
+      "since": "1.0.0-beta.0",
       "category": "disclosure"
     },
     "Alert": {