Exclude page versions (#279)

<img width="836" height="383" alt="image"
src="https://github.com/user-attachments/assets/50c79ca3-6c77-477c-b7c1-f59b770b3a83"
/>

Author: fantkolja

preview-src/ui-model.yml

@@ -75,7 +75,7 @@ page:
   title: Java Client
   attributes:
     component-order: '!home, !templates, !imdg, !privacy, hazelcast, management-center, cloud, *'
-    excluded-versions: 'hazelcast:4.0'
+    excluded-versions: 'management-center:4.0'
     last-versions-count: 10
   component:
     name: management-center

src/helpers/filter-out-excluded-versions.js

@@ -0,0 +1,20 @@
+'use strict'
+
+module.exports = ({ data: { root } }) => {
+  let versions = root.page.versions
+  const excludedVersions = root.page.attributes['excluded-versions']
+  const currentComponentName = root.page.component.name
+  if (excludedVersions) {
+    const excludedComponentVersions = excludedVersions.split(',').map((it) => it.trim())
+    // console.debug('[DEBUG:SORT_COMPONENTS] excluding versions: ', excludedComponentVersions)
+    excludedComponentVersions.forEach((componentVersion) => {
+      const [componentName, excludedVersionName] = componentVersion.split(':')
+      if (currentComponentName === componentName) {
+        versions = versions.filter(({ version }) => {
+          return version !== excludedVersionName
+        })
+      }
+    })
+  }
+  return versions
+}

src/helpers/sort-components.js

@@ -1,30 +1,6 @@
 'use strict'
 
-// filter out excluded versions
-const excludeComponentVersions = (targetCollection, page) => {
-  if (page.attributes['excluded-versions']) {
-    const excludedComponentVersions = page.attributes['excluded-versions']
-      .split(',').map((it) => it.trim())
-    // console.debug('[DEBUG:SORT_COMPONENTS] excluding versions: ', excludedComponentVersions)
-    excludedComponentVersions.forEach((componentVersion, index) => {
-      const [componentName, versionName] = componentVersion.split(':')
-      const component = targetCollection.find(({ name }) => name === componentName)
-      if (!component) {
-        console.warn(`No component found for excluded-versions[${index}] -> ${componentVersion}`)
-      } else {
-        component.versions = component.versions.map((nextVersion) => {
-          return {
-            ...nextVersion,
-            isHidden: nextVersion.version === versionName,
-          }
-        })
-      }
-    })
-  }
-  return targetCollection
-}
-
-module.exports = (collection, property, orderSpec, { data: { root } }) => {
+module.exports = (collection, property, orderSpec) => {
   if (orderSpec == null || orderSpec === '*') return Object.values(collection)
   const sourceCollection = Object.values(collection).reduce((accum, it) => accum.set(it[property], it), new Map())
   const order = orderSpec
@@ -36,15 +12,13 @@ module.exports = (collection, property, orderSpec, { data: { root } }) => {
     })
   const restIdx = order.indexOf('*')
   if (~restIdx) order.splice(restIdx, 1)
-  let targetCollection = order.reduce((accum, key) => {
+  const targetCollection = order.reduce((accum, key) => {
     if (sourceCollection.has(key)) {
       accum.push(sourceCollection.get(key))
       sourceCollection.delete(key)
     }
     return accum
   }, [])
   if (~restIdx) targetCollection.splice(restIdx, 0, ...sourceCollection.values())
-  targetCollection = excludeComponentVersions(targetCollection, root.page)
-  // console.debug('[DEBUG:SORT_COMPONENTS] targetCollection: ', targetCollection)
   return targetCollection
 }

src/partials/nav-explore.hbs

@@ -26,16 +26,14 @@
   {{#with page.versions}}
     {{#if (and (not-eq @root.page.component.name 'cloud') (not-eq @root.page.component.name 'home') (not-eq @root.page.component.name 'templates'))}}
       <ul class="nav-version-picker-versions" id="navbarVersionsList">
-        {{#each this}}
-          {{#unless ./isHidden}}
-            {{#if (lte @index 10)}}
-              <li
-                class="version {{~#if (eq ./version @root.page.version)}} is-current{{/if~}}"
-              >
-                <a href="{{{relativize ./url}}}">{{./displayVersion}}</a>
-              </li>
-            {{/if}}
-          {{/unless}}
+        {{#each (filter-out-excluded-versions)}}
+          {{#if (lte @index 10)}}
+            <li
+              class="version {{~#if (eq ./version @root.page.version)}} is-current{{/if~}}"
+            >
+              <a href="{{{relativize ./url}}}">{{./displayVersion}}</a>
+            </li>
+          {{/if}}
         {{/each}}
       </ul>
     {{/if}}

src/partials/page-versions.hbs

@@ -2,7 +2,7 @@
   <div class="page-versions">
     <button class="version-menu-toggle" title="Show other versions of page">Version {{@root.page.componentVersion.displayVersion}}</button>
     <div class="version-menu">
-      {{#each this}}
+      {{#each (filter-out-excluded-versions)}}
         {{#if (lte @index 10)}}
           <a class="version
             {{~#if (eq ./version @root.page.version)}} is-current{{/if~}}