feat(default-theme): support route-specific version labels

dev/vite.config.mts

@@ -112,6 +112,7 @@ export default defineConfig({
 				},
 				{
 					version: "v1",
+					versionLabel: "v1 (legacy)",
 					title: "SolidBase v1 Demo",
 					themeConfig: {
 						sidebar: {

docs/src/routes/guide/(2)config.mdx

@@ -55,6 +55,7 @@ interface SolidBaseConfig<ThemeConfig> {
   robots?: boolean | RobotsConfig;
   lang?: string;
   locales?: Record<string, LocaleConfig<ThemeConfig>>;
+    versionLabel?: string;
   routes?: SolidBaseRoutesConfig;
   overrides?: Array<SolidBaseRouteOverride<ThemeConfig>>;
   themeConfig?: ThemeConfig;
@@ -170,12 +171,13 @@ overrides: [
     {
         project: "solidbase",
         version: "v1",
+        versionLabel: "v1 (legacy)",
     },
 ],
 // ..
 ```
 
-Route override selectors use route axis names. Override config is applied over the base config, and `themeConfig` is shallow-merged with the base `themeConfig`.
+Route override selectors use route axis names. Override config is applied over the base config, and `themeConfig` is shallow-merged with the base `themeConfig`. Use `versionLabel` to replace the active version selector label for a matching route without changing the version label shown elsewhere.
 
 #### Miscellaneous options
 

docs/src/routes/reference/default-theme/components/version-selector.mdx

@@ -21,6 +21,7 @@ Version switcher for sites that configure `routes.version`.
 
 - omitted when fewer than two version options are available
 - uses Kobalte `Popover`
+- uses the resolved `versionLabel` for the active version when configured
 - displays each version option's `meta.label` when provided, otherwise the option name
 - navigates to the selected version's route root
 - scopes available versions to the current project

src/config/index.ts

@@ -26,6 +26,7 @@ const SOLID_BASE_OVERRIDE_CONFIG_KEYS = [
 	"issueAutolink",
 	"lang",
 	"locales",
+	"versionLabel",
 	"themeConfig",
 	"editPath",
 	"lastUpdated",
@@ -46,6 +47,7 @@ export interface SolidBaseConfig<ThemeConfig> {
 	issueAutolink?: IssueAutoLinkConfig | false;
 	lang?: string;
 	locales?: Record<string, LocaleConfig<ThemeConfig>>;
+	versionLabel?: string;
 	routes?: SolidBaseRoutesConfig;
 	overrides?: Array<SolidBaseRouteOverride<ThemeConfig>>;
 	themeConfig?: ThemeConfig;

src/default-theme/components/VersionSelector.tsx

@@ -45,7 +45,9 @@ export default function VersionSelector() {
 						aria-label="Change version"
 						disabled={options().length <= 1}
 					>
-						<span class={styles.label}>{getOptionLabel(current())}</span>
+						<span class={styles.label}>
+							{config().versionLabel ?? getOptionLabel(current())}
+						</span>
 
 						<Show when={options().length > 1}>
 							<IconExpandUpDownLine class={styles.icon} aria-hidden />

tests/config/index.test.ts

@@ -141,7 +141,7 @@ describe("createSolidBase", () => {
 			solidBase.plugin({
 				routes: validRoutes,
 				overrides: [
-					{ version: "v1", title: "v1" },
+					{ version: "v1", versionLabel: "v1 (legacy)", title: "v1" },
 					{ locale: ["en", "fr"], themeConfig: { nav: [] } },
 				],
 			}),

tests/config/route-config.test.ts

@@ -227,6 +227,7 @@ describe("route config helpers", () => {
 						project: "solid",
 						version: "v1",
 						locale: "fr",
+						versionLabel: "v1 (legacy)",
 						title: "Solid v1 FR",
 					},
 				],
@@ -236,6 +237,7 @@ describe("route config helpers", () => {
 
 		expect(config).toMatchObject({
 			title: "Solid v1 FR",
+			versionLabel: "v1 (legacy)",
 			themeConfig: {
 				nav: ["solid"],
 				sidebar: { "/fr": [] },