From d72ed1a45b4f2d740c8dff7c1296d8278ba2fdb7 Mon Sep 17 00:00:00 2001
From: flash <flash7777>
Date: Sun, 21 Jun 2026 15:04:48 +0200
Subject: [PATCH 1/3] feat(files): add space header extension point

Add `app.files.space-header` extension point that allows extensions
to provide a custom component in place of the default SpaceHeader
on project space frontpages.

When an extension registers at this point, its component is rendered
instead of the built-in SpaceHeader. When no extension is registered,
the default SpaceHeader is shown as before.

This enables folder view extensions to render their own space header
with domain-specific information without modifying the core.
---
 packages/web-app-files/src/extensionPoints.ts  |  6 ++++++
 .../src/views/spaces/GenericSpace.vue          | 18 ++++++++++++++++--
 2 files changed, 22 insertions(+), 2 deletions(-)

diff --git a/packages/web-app-files/src/extensionPoints.ts b/packages/web-app-files/src/extensionPoints.ts
index 22f439113e..727a19c07d 100644
--- a/packages/web-app-files/src/extensionPoints.ts
+++ b/packages/web-app-files/src/extensionPoints.ts
@@ -97,6 +97,11 @@ export const folderViewsSearchExtensionPoint: ExtensionPoint<FolderViewExtension
   extensionType: 'folderView'
 }
 
+export const spaceHeaderExtensionPoint: ExtensionPoint<CustomComponentExtension> = {
+  id: 'app.files.space-header',
+  extensionType: 'customComponent'
+}
+
 export const fileSideBarFileDetailsTableExtensionPoint: ExtensionPoint<CustomComponentExtension> = {
   id: 'app.files.sidebar.file-details.table',
   extensionType: 'customComponent'
@@ -133,6 +138,7 @@ export const extensionPoints = () => {
       folderViewsSharedViaLinkExtensionPoint,
       folderViewsSharedWithOthersExtensionPoint,
       folderViewsSearchExtensionPoint,
+      spaceHeaderExtensionPoint,
       floatingActionButtonExtension,
       fileSideBarFileDetailsTableExtensionPoint,
       fileSideBarSharesPanelSharedWithTopExtensionPoint,
diff --git a/packages/web-app-files/src/views/spaces/GenericSpace.vue b/packages/web-app-files/src/views/spaces/GenericSpace.vue
index f82ee83a3c..743441e77a 100644
--- a/packages/web-app-files/src/views/spaces/GenericSpace.vue
+++ b/packages/web-app-files/src/views/spaces/GenericSpace.vue
@@ -31,7 +31,15 @@
           :class="{ 'h-[40vh]': isSpaceFrontpage }"
         />
         <template v-else>
-          <space-header v-if="isSpaceFrontpage" :space="space" class="px-4" />
+          <custom-component-target
+            v-if="isSpaceFrontpage && hasSpaceHeaderExtension"
+            :extension-point="spaceHeaderExtensionPoint"
+          />
+          <space-header
+            v-else-if="isSpaceFrontpage"
+            :space="space"
+            class="px-4"
+          />
           <no-content-message
             v-if="isCurrentFolderEmpty"
             id="files-space-empty"
@@ -146,8 +154,10 @@ import {
   useKeyboardActions,
   useRoute,
   useRouteQuery,
-  FolderLoaderOptions
+  FolderLoaderOptions,
+  CustomComponentTarget
 } from '@opencloud-eu/web-pkg'
+import { spaceHeaderExtensionPoint } from '../../extensionPoints'
 import CreateAndUpload from '../../components/AppBar/CreateAndUpload.vue'
 import FilesViewWrapper from '../../components/FilesViewWrapper.vue'
 import ListInfo from '../../components/FilesList/ListInfo.vue'
@@ -200,6 +210,10 @@ const canUpload = computed(() => {
 })
 
 const folderNotFound = computed(() => unref(currentFolder) === null)
+
+const hasSpaceHeaderExtension = computed(() => {
+  return extensionRegistry.requestExtensions(spaceHeaderExtensionPoint).length > 0
+})
 const isCurrentFolderEmpty = computed(() => unref(paginatedResources).length < 1)
 
 const titleSegments = computed(() => {

From 859201072fd3a00546af62d402a465d06f471266 Mon Sep 17 00:00:00 2001
From: flash <flash7777>
Date: Tue, 23 Jun 2026 14:02:37 +0200
Subject: [PATCH 2/3] refactor: rename to generic-space-header, always render,
 keep SpaceHeader
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Per review feedback:
- Extension point renamed to app.files.generic-space-header
- Removed isSpaceFrontpage check — extensions decide visibility
- Default SpaceHeader always rendered (not hidden by extension)
- Extensions can hide the default SpaceHeader via CSS if needed
---
 packages/web-app-files/src/extensionPoints.ts        |  6 +++---
 .../web-app-files/src/views/spaces/GenericSpace.vue  | 12 ++++++------
 2 files changed, 9 insertions(+), 9 deletions(-)

diff --git a/packages/web-app-files/src/extensionPoints.ts b/packages/web-app-files/src/extensionPoints.ts
index 727a19c07d..2d53bef30b 100644
--- a/packages/web-app-files/src/extensionPoints.ts
+++ b/packages/web-app-files/src/extensionPoints.ts
@@ -97,8 +97,8 @@ export const folderViewsSearchExtensionPoint: ExtensionPoint<FolderViewExtension
   extensionType: 'folderView'
 }
 
-export const spaceHeaderExtensionPoint: ExtensionPoint<CustomComponentExtension> = {
-  id: 'app.files.space-header',
+export const genericSpaceHeaderExtensionPoint: ExtensionPoint<CustomComponentExtension> = {
+  id: 'app.files.generic-space-header',
   extensionType: 'customComponent'
 }
 
@@ -138,7 +138,7 @@ export const extensionPoints = () => {
       folderViewsSharedViaLinkExtensionPoint,
       folderViewsSharedWithOthersExtensionPoint,
       folderViewsSearchExtensionPoint,
-      spaceHeaderExtensionPoint,
+      genericSpaceHeaderExtensionPoint,
       floatingActionButtonExtension,
       fileSideBarFileDetailsTableExtensionPoint,
       fileSideBarSharesPanelSharedWithTopExtensionPoint,
diff --git a/packages/web-app-files/src/views/spaces/GenericSpace.vue b/packages/web-app-files/src/views/spaces/GenericSpace.vue
index 743441e77a..b41f240c28 100644
--- a/packages/web-app-files/src/views/spaces/GenericSpace.vue
+++ b/packages/web-app-files/src/views/spaces/GenericSpace.vue
@@ -32,11 +32,11 @@
         />
         <template v-else>
           <custom-component-target
-            v-if="isSpaceFrontpage && hasSpaceHeaderExtension"
-            :extension-point="spaceHeaderExtensionPoint"
+            v-if="hasGenericSpaceHeaderExtension"
+            :extension-point="genericSpaceHeaderExtensionPoint"
           />
           <space-header
-            v-else-if="isSpaceFrontpage"
+            v-if="isSpaceFrontpage"
             :space="space"
             class="px-4"
           />
@@ -157,7 +157,7 @@ import {
   FolderLoaderOptions,
   CustomComponentTarget
 } from '@opencloud-eu/web-pkg'
-import { spaceHeaderExtensionPoint } from '../../extensionPoints'
+import { genericSpaceHeaderExtensionPoint } from '../../extensionPoints'
 import CreateAndUpload from '../../components/AppBar/CreateAndUpload.vue'
 import FilesViewWrapper from '../../components/FilesViewWrapper.vue'
 import ListInfo from '../../components/FilesList/ListInfo.vue'
@@ -211,8 +211,8 @@ const canUpload = computed(() => {
 
 const folderNotFound = computed(() => unref(currentFolder) === null)
 
-const hasSpaceHeaderExtension = computed(() => {
-  return extensionRegistry.requestExtensions(spaceHeaderExtensionPoint).length > 0
+const hasGenericSpaceHeaderExtension = computed(() => {
+  return extensionRegistry.requestExtensions(genericSpaceHeaderExtensionPoint).length > 0
 })
 const isCurrentFolderEmpty = computed(() => unref(paginatedResources).length < 1)
 

From 1e3a9d069a1732c45b72efdb5bf74ff26124b5d2 Mon Sep 17 00:00:00 2001
From: flash <flash7777>
Date: Mon, 29 Jun 2026 19:00:26 +0200
Subject: [PATCH 3/3] fix: CustomComponentTarget fallback slot pattern
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- CustomComponentTarget: track mounted children, show fallback slot
  when no extension renders visible content (Comment nodes skipped)
- GenericSpace: use fallback slot for SpaceHeader — only rendered
  when extension decides not to render its own header
- Ensures extension point works as passthrough: if extension renders
  nothing (v-if="false"), default SpaceHeader appears as fallback
---
 .../src/views/spaces/GenericSpace.vue         | 14 ++++++--
 .../src/components/CustomComponentTarget.vue  | 35 +++++++++++++++----
 2 files changed, 39 insertions(+), 10 deletions(-)

diff --git a/packages/web-app-files/src/views/spaces/GenericSpace.vue b/packages/web-app-files/src/views/spaces/GenericSpace.vue
index b41f240c28..7470676e2c 100644
--- a/packages/web-app-files/src/views/spaces/GenericSpace.vue
+++ b/packages/web-app-files/src/views/spaces/GenericSpace.vue
@@ -34,9 +34,17 @@
           <custom-component-target
             v-if="hasGenericSpaceHeaderExtension"
             :extension-point="genericSpaceHeaderExtensionPoint"
-          />
+          >
+            <template #fallback>
+              <space-header
+                v-if="isSpaceFrontpage"
+                :space="space"
+                class="px-4"
+              />
+            </template>
+          </custom-component-target>
           <space-header
-            v-if="isSpaceFrontpage"
+            v-else-if="isSpaceFrontpage"
             :space="space"
             class="px-4"
           />
@@ -115,7 +123,7 @@
 <script setup lang="ts">
 import { omit, last } from 'lodash-es'
 import { basename } from 'path'
-import { computed, onBeforeUnmount, onMounted, unref, watch } from 'vue'
+import { computed, onBeforeUnmount, onMounted, ref, unref, watch } from 'vue'
 import { useGettext } from 'vue3-gettext'
 import { Resource } from '@opencloud-eu/web-client'
 import {
diff --git a/packages/web-pkg/src/components/CustomComponentTarget.vue b/packages/web-pkg/src/components/CustomComponentTarget.vue
index 712eb2aee3..e6dd4c7c8f 100644
--- a/packages/web-pkg/src/components/CustomComponentTarget.vue
+++ b/packages/web-pkg/src/components/CustomComponentTarget.vue
@@ -1,14 +1,17 @@
 <template>
-  <component
-    :is="extension.content"
-    v-for="extension in extensions"
-    :key="`custom-component-${extension.id}`"
-    v-bind="extension.componentProps ? extension.componentProps() : undefined"
-  />
+  <template v-for="extension in extensions" :key="`custom-component-${extension.id}`">
+    <component
+      :is="extension.content"
+      v-bind="extension.componentProps ? extension.componentProps() : undefined"
+      @vue:mounted="onChildMounted"
+      @vue:unmounted="onChildUnmounted"
+    />
+  </template>
+  <slot v-if="!hasRenderedContent" name="fallback" />
 </template>
 
 <script setup lang="ts">
-import { computed, unref } from 'vue'
+import { computed, ref, unref } from 'vue'
 import {
   CustomComponentExtension,
   ExtensionPoint,
@@ -23,6 +26,24 @@ const props = defineProps<{
 const extensionRegistry = useExtensionRegistry()
 const extensionPreferences = useExtensionPreferencesStore()
 
+// Track whether any extension component actually rendered visible content
+const mountedCount = ref(0)
+const hasRenderedContent = computed(() => mountedCount.value > 0)
+
+function onChildMounted(e: any) {
+  // Check if the component rendered something visible (not just a comment node)
+  const el = e?.el
+  if (el && el.nodeType !== 8 /* Comment */) {
+    mountedCount.value++
+  }
+}
+
+function onChildUnmounted() {
+  if (mountedCount.value > 0) mountedCount.value--
+}
+
+defineExpose({ hasRenderedContent })
+
 const allExtensions = computed(() => {
   return extensionRegistry.requestExtensions(props.extensionPoint)
 })