@dogsbay/docs-layout 0.2.0-beta.93 → 0.2.0-beta.95

package/src/switcher.ts

@@ -11,6 +11,14 @@ export interface AxisEntry {
   id: string;
   label?: string;
   eol?: boolean;
+  /** Pre-release mark (version axis only) — the moving next/beta head. */
+  prerelease?: boolean;
+  /**
+   * Served but kept OFF the switcher (version axis only). Marks the number
+   * a `latest` alias points at, so the dropdown shows one "3.32 (latest)"
+   * row instead of both "latest" and "3.32".
+   */
+  hidden?: boolean;
   default?: boolean;
 }
 
@@ -73,9 +81,32 @@ export interface BuildRowsInput {
   multiSource: MultiSourceMeta;
 }
 
+/**
+ * Order two version ids. Compares numeric components left-to-right
+ * (`3.32` > `3.31`, `3.23-2` > `3.23-1`); a non-numeric alias (`latest`,
+ * `next`) sorts ABOVE any numbered version so descending order puts it
+ * first. When NEITHER id has any digits — a non-semver / codename scheme
+ * (`Boron`, `Argon`) — returns 0 so the sort is a no-op and the author's
+ * DECLARED order is preserved (JS sort is stable), rather than silently
+ * alphabetising and putting the newest release at the bottom.
+ */
+export function compareVersionIds(a: string, b: string): number {
+  const na = (a.match(/\d+/g) ?? []).map(Number);
+  const nb = (b.match(/\d+/g) ?? []).map(Number);
+  if (na.length === 0 && nb.length === 0) return 0; // codenames → keep declared order
+  if (na.length === 0) return 1; // alias > number
+  if (nb.length === 0) return -1;
+  const len = Math.max(na.length, nb.length);
+  for (let i = 0; i < len; i++) {
+    const d = (na[i] ?? 0) - (nb[i] ?? 0);
+    if (d !== 0) return d;
+  }
+  return a.localeCompare(b);
+}
+
 export function buildSwitcherRows(input: BuildRowsInput): SwitcherRow[] {
   const { axis, switcherMap, multiSource } = input;
-  const entries = axis === "version" ? switcherMap.versions : switcherMap.locales;
+  const allEntries = axis === "version" ? switcherMap.versions : switcherMap.locales;
   const currentId =
     axis === "version" ? multiSource.version : multiSource.locale;
   const otherAxis: SwitcherAxis = axis === "version" ? "locale" : "version";
@@ -84,6 +115,56 @@ export function buildSwitcherRows(input: BuildRowsInput): SwitcherRow[] {
 
   const variants = switcherMap.byLogicalKey[logicalKeyFor(multiSource)] ?? [];
 
+  // On a MULTI-PRODUCT (namespace-active) site the declared version list
+  // is the UNION across products, but a page's variants are same-namespace
+  // (the logical key is namespaced). Scope the version switcher to the
+  // versions this page's product actually has, so a Calico page never
+  // offers a Calico-Enterprise version. Single-product sites (no
+  // namespace) keep the full declared list, with fallbacks for pages
+  // missing in some version.
+  let entries = allEntries;
+  if (axis === "version" && multiSource.namespace !== undefined) {
+    const available = new Set(
+      variants.map((v) => v.version).filter((v): v is string => v !== undefined),
+    );
+    entries = allEntries.filter((e) => available.has(e.id) || e.id === currentId);
+  }
+
+  // The version dropdown always reads newest → oldest (3.32, 3.31, …),
+  // regardless of the declared order. Aliases (e.g. "latest") that don't
+  // parse as versions sort to the top, ahead of the numbers.
+  //
+  // `latest` alias + its target: a version marked `hidden` is the number
+  // the `latest` alias points at (Docusaurus's lastVersion). Show ONE row
+  // "3.32 (latest)" (linking to /latest/), derive its label from the hidden
+  // sibling, and drop hidden rows from the dropdown.
+  //
+  // The hidden number is DECLARED but NOT SERVED: `migrate-docusaurus
+  // --latest-alias` emits one source for the newest branch, at `latest`.
+  // That mirrors the source, where `versions: { "3.32": { path: "latest" } }`
+  // REPLACES the segment — docs.tigera.io has /calico/latest/ and no
+  // /calico/3.32/. Serving both invented a URL tree the source never had
+  // and duplicated every page of the newest release (338 on Calico) with
+  // no canonical. So the hidden entry is label-only metadata.
+  //
+  // `currentFoldedIntoLatest` still matters for a corpus that DOES serve
+  // the number (a hand-written config may), so a reader on `/3.32/…` has
+  // the merged `latest` row highlighted rather than no row at all. No
+  // `hidden` sibling → no merge.
+  let currentFoldedIntoLatest = false;
+  if (axis === "version") {
+    entries = [...entries].sort((a, b) => compareVersionIds(b.id, a.id));
+    const hiddenTarget = entries.find((e) => e.hidden && /\d/.test(e.id));
+    currentFoldedIntoLatest = hiddenTarget?.id === currentId;
+    entries = entries
+      .filter((e) => !e.hidden)
+      .map((e) =>
+        e.id === "latest" && hiddenTarget
+          ? { ...e, label: `${hiddenTarget.label ?? hiddenTarget.id} (latest)` }
+          : e,
+      );
+  }
+
   return entries.map((entry) => {
     const match = variants.find((v) => {
       // Match on this axis.
@@ -98,7 +179,7 @@ export function buildSwitcherRows(input: BuildRowsInput): SwitcherRow[] {
     return {
       entry,
       url: match?.url ?? null,
-      isCurrent: entry.id === currentId,
+      isCurrent: entry.id === currentId || (entry.id === "latest" && currentFoldedIntoLatest),
     };
   });
 }