@conduction/nextcloud-vue 2.73.0 → 2.73.1

package/dist/nextcloud-vue.cjs.js

@@ -136551,7 +136551,7 @@ var script$3W = {
 		},
 	},
 
-	emits: ['geo-saved', 'open-integration'],
+	emits: ['geo-saved', 'open-integration', 'select-object'],
 
 	setup() {
 		// Every integration component this host renders goes through the
@@ -137056,6 +137056,21 @@ var script$3W = {
 			this.$emit('open-integration', integrationId);
 		},
 
+		/**
+		 * Pass a related-object click up; the page decides where it opens. Heard
+		 * from the Related widget itself and from a registry widget that nests a
+		 * host of its own (a Tabs widget with a Related tab).
+		 *
+		 * @param {object} raw The clicked object as the related widget holds it.
+		 */
+		onSelectObject(raw) {
+			/**
+			 * @event select-object A related object was clicked in the related widget. Payload is the raw object; its `@self` names the register and schema.
+			 * @type {object}
+			 */
+			this.$emit('select-object', raw);
+		},
+
 		/**
 		 * Delegate to the rendered list widget's own create affordance, so the
 		 * card's Add action and the widget's footer button open the same form.
@@ -137158,8 +137173,9 @@ function render$3W(_ctx, _cache, $props, $setup, $data, $options) {
               includeGroups: $options.content.groups || [],
               hideSingleTabTitle: $options.content.hideSingleTabTitle !== false,
               showTotalCount: $options.content.showTotalCount !== false,
-              onOpenIntegration: $options.onOpenIntegration
-            }, null, 8 /* PROPS */, ["title", "bare", "objectType", "objectId", "objectData", "register", "schema", "store", "includeGroups", "hideSingleTabTitle", "showTotalCount", "onOpenIntegration"]))
+              onOpenIntegration: $options.onOpenIntegration,
+              onSelectObject: $options.onSelectObject
+            }, null, 8 /* PROPS */, ["title", "bare", "objectType", "objectId", "objectData", "register", "schema", "store", "includeGroups", "hideSingleTabTitle", "showTotalCount", "onOpenIntegration", "onSelectObject"]))
           : ($options.isGeo)
             ? (vue$1.openBlock(), vue$1.createBlock(_component_CnObjectGeoWidget, {
                 key: 3,
@@ -137198,7 +137214,7 @@ function render$3W(_ctx, _cache, $props, $setup, $data, $options) {
                       class: "cn-detail-page__catalog-card"
                     }, vue$1.createSlots({
                       default: vue$1.withCtx(() => [
-                        (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent($options.renderer), vue$1.mergeProps({ ref: "renderer" }, $options.rendererProps), null, 16 /* FULL_PROPS */))
+                        (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent($options.renderer), vue$1.mergeProps({ ref: "renderer" }, $options.rendererProps, { onSelectObject: $options.onSelectObject }), null, 16 /* FULL_PROPS */, ["onSelectObject"]))
                       ]),
                       _: 2 /* DYNAMIC */
                     }, [
@@ -137266,7 +137282,7 @@ function render$3W(_ctx, _cache, $props, $setup, $data, $options) {
                       ? (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent($options.renderer), vue$1.mergeProps({
                           key: 8,
                           ref: "renderer"
-                        }, $options.rendererProps), null, 16 /* FULL_PROPS */))
+                        }, $options.rendererProps, { onSelectObject: $options.onSelectObject }), null, 16 /* FULL_PROPS */, ["onSelectObject"]))
                       : vue$1.createCommentVNode("v-if", true)
   ], 2 /* CLASS */))
 }
@@ -138248,7 +138264,7 @@ var script$3T = {
 		},
 	},
 
-	emits: ['geo-saved', 'open-integration'],
+	emits: ['geo-saved', 'open-integration', 'select-object'],
 
 	data() {
 		return {
@@ -138421,6 +138437,20 @@ var script$3T = {
 			this.$emit('open-integration', integrationId);
 		},
 
+		/**
+		 * Re-emit a related child's object click; the page opens the object.
+		 *
+		 * @param {object} raw The clicked object.
+		 * @return {void}
+		 */
+		onSelectObject(raw) {
+			/**
+			 * @event select-object Re-emitted from a related child whose object row was clicked. Payload is the raw object.
+			 * @type {object}
+			 */
+			this.$emit('select-object', raw);
+		},
+
 		/**
 		 * Follow the strip's own selection, so keyboard navigation moves the
 		 * hoisted Actions menu too.
@@ -138547,8 +138577,9 @@ function render$3T(_ctx, _cache, $props, $setup, $data, $options) {
                     integrationContext: $props.integrationContext,
                     cnRegistry: $props.cnRegistry,
                     onGeoSaved: $options.onGeoSaved,
-                    onOpenIntegration: $options.onOpenIntegration
-                  }, null, 8 /* PROPS */, ["widget", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "cnRegistry", "onGeoSaved", "onOpenIntegration"]))
+                    onOpenIntegration: $options.onOpenIntegration,
+                    onSelectObject: $options.onSelectObject
+                  }, null, 8 /* PROPS */, ["widget", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "cnRegistry", "onGeoSaved", "onOpenIntegration", "onSelectObject"]))
                 : (vue$1.openBlock(), vue$1.createBlock(_component_NcEmptyContent, {
                     key: 1,
                     name: $options.missingLabel(entry)
@@ -248344,7 +248375,7 @@ function namedFilterToQuery(values) {
  * @event {object} row-aux-click — Table row or card middle-clicked. Payload: (row, event) — the row object and the native auxclick event
  * @event {{ key: string, order: string }} sort — Column sort changed
  * @event {number} page-changed — Pagination page changed
- * @event {number} page-size-changed — Pagination page size changed
+ * @event {number} page-size-changed — Pagination page size changed. In self-fetch mode the list refetches page 1 at the new size first.
  * @event {string[]} select — Selection changed. Payload: array of selected IDs
  * @event {object} action — Row action triggered. Payload: { action, row }
  * @event {{ action: string, id: string, selectedIds: Array, count: number }} bulk-action — A declarative bulk action was triggered from the selection strip. The SELECTION travels with it: an action that has to go and find out what was selected is one re-render away from acting on a different set than the user saw highlighted.
@@ -252769,6 +252800,21 @@ var script$1A = {
 			this.$emit('page-changed', page);
 		},
 
+		/**
+		 * Page-size pick from CnPagination. In self-fetch mode the list refetches
+		 * page 1 at the new size — the event alone left the select changing and
+		 * the table not, since a manifest page has no host listening.
+		 *
+		 * @param {number} size Requested page size.
+		 * @return {void}
+		 */
+		onPageSizeEvent(size) {
+			if (this.isSelfFetchMode && typeof this.list.onPageSizeChange === 'function') {
+				this.list.onPageSizeChange(size);
+			}
+			this.$emit('page-size-changed', size);
+		},
+
 		/**
 		 * @param {{key: string, values: Array}} payload Facet-filter change from the sidebar.
 		 * @return {void}
@@ -254376,7 +254422,7 @@ function render$1A(_ctx, _cache, $props, $setup, $data, $options) {
   return (vue$1.openBlock(), vue$1.createElementBlock("div", {
     class: "cn-index-page",
     "data-testid": "cn-index-page",
-    onKeydown: _cache[26] || (_cache[26] = (...args) => ($options.onListKeydown && $options.onListKeydown(...args)))
+    onKeydown: _cache[25] || (_cache[25] = (...args) => ($options.onListKeydown && $options.onListKeydown(...args)))
   }, [
     vue$1.renderSlot(_ctx.$slots, "header", {
       title: $props.title,
@@ -254866,7 +254912,7 @@ function render$1A(_ctx, _cache, $props, $setup, $data, $options) {
 					'cn-index-page__main--table': $data.currentViewMode === 'table',
 					'cn-index-page__main--split': $options.splitLayout === 'split',
 				}]),
-        onScroll: _cache[23] || (_cache[23] = (...args) => ($options.onListScroll && $options.onListScroll(...args)))
+        onScroll: _cache[22] || (_cache[22] = (...args) => ($options.onListScroll && $options.onListScroll(...args)))
       }, [
         vue$1.renderSlot(_ctx.$slots, "before-collection"),
         ($options.showInitialLoader)
@@ -255235,8 +255281,8 @@ function render$1A(_ctx, _cache, $props, $setup, $data, $options) {
               currentPageSize: $options.effectivePagination.limit || 20,
               class: "cn-index-page__pagination",
               onPageChanged: $options.onPageEvent,
-              onPageSizeChanged: _cache[22] || (_cache[22] = $event => (_ctx.$emit('page-size-changed', $event)))
-            }, null, 8 /* PROPS */, ["currentPage", "totalPages", "totalItems", "currentPageSize", "onPageChanged"]))
+              onPageSizeChanged: $options.onPageSizeEvent
+            }, null, 8 /* PROPS */, ["currentPage", "totalPages", "totalItems", "currentPageSize", "onPageChanged", "onPageSizeChanged"]))
           : vue$1.createCommentVNode("v-if", true)
       ], 34 /* CLASS, NEED_HYDRATION */), [
         [vue$1.vShow, $options.splitLayout !== 'detail']
@@ -255256,7 +255302,7 @@ function render$1A(_ctx, _cache, $props, $setup, $data, $options) {
                   href: $options.splitCloseHref,
                   title: $options.splitCloseTitle,
                   "data-testid": "cn-index-page-split-close",
-                  onClick: _cache[24] || (_cache[24] = vue$1.withModifiers((...args) => ($options.closeSplitPane && $options.closeSplitPane(...args)), ["prevent"]))
+                  onClick: _cache[23] || (_cache[23] = vue$1.withModifiers((...args) => ($options.closeSplitPane && $options.closeSplitPane(...args)), ["prevent"]))
                 }, [
                   vue$1.createVNode(_component_Close, { size: 16 }),
                   vue$1.createElementVNode("span", null, vue$1.toDisplayString($options.splitCloseTitle), 1 /* TEXT */)
@@ -255286,7 +255332,7 @@ function render$1A(_ctx, _cache, $props, $setup, $data, $options) {
           facetData: $options.effectiveFacetData,
           showMetadata: $options.resolvedSidebar.showMetadata !== false
         }, $options.sidebarSearchProps, {
-          "onUpdate:open": _cache[25] || (_cache[25] = $event => ($data.sidebarOpen = $event)),
+          "onUpdate:open": _cache[24] || (_cache[24] = $event => ($data.sidebarOpen = $event)),
           onSearch: $options.onSearchEvent,
           onColumnsChange: $options.onColumnsEvent,
           onFilterChange: $options.onFilterEvent,
@@ -268586,6 +268632,7 @@ var script$1c = {
 		'layout-change',
 		'open-integration',
 		'refresh',
+		'related-object-click',
 		'related-row-click',
 		'relation-linked',
 		'request-feature',
@@ -270567,6 +270614,23 @@ var script$1c = {
 			this.$emit('open-integration', integrationId);
 		},
 
+		/**
+		 * Re-emit a click on an object in the Related widget. The page does not
+		 * know the routes; the host (CnPageRenderer on a manifest page) opens
+		 * the object's own detail page.
+		 *
+		 * @param {object} raw The clicked object; `@self` names its register and schema.
+		 */
+		onRelatedObjectSelect(raw) {
+			/**
+			 * @event related-object-click An object in the Related widget was
+			 * clicked. Payload is the raw object; `@self` carries its register,
+			 * schema and id.
+			 * @type {object}
+			 */
+			this.$emit('related-object-click', raw);
+		},
+
 		/**
 		 * Re-fetch the object after the geo widget persists `@self.geo` (so the
 		 * rest of the page — metadata, other widgets — reflects the new value),
@@ -272377,8 +272441,9 @@ function render$1c(_ctx, _cache, $props, $setup, $data, $options) {
                     cnRegistry: $options.cnRegistry,
                     availableWidgets: _ctx.widgets,
                     onGeoSaved: $options.onGeoSaved,
-                    onOpenIntegration: $options.onAutoBodyOpenIntegration
-                  }, null, 8 /* PROPS */, ["widget", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "hideEmpty", "cnRegistry", "availableWidgets", "onGeoSaved", "onOpenIntegration"])
+                    onOpenIntegration: $options.onAutoBodyOpenIntegration,
+                    onSelectObject: $options.onRelatedObjectSelect
+                  }, null, 8 /* PROPS */, ["widget", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "hideEmpty", "cnRegistry", "availableWidgets", "onGeoSaved", "onOpenIntegration", "onSelectObject"])
                 ])
               ]))
             : vue$1.createCommentVNode("v-if", true)
@@ -272602,8 +272667,9 @@ function render$1c(_ctx, _cache, $props, $setup, $data, $options) {
                             cnRegistry: $options.cnRegistry,
                             availableWidgets: $options.bodyGridWidgets,
                             onGeoSaved: $options.onGeoSaved,
-                            onOpenIntegration: $options.onAutoBodyOpenIntegration
-                          }, null, 8 /* PROPS */, ["widget", "showCardTitle", "showActions", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "hideEmpty", "cnRegistry", "availableWidgets", "onGeoSaved", "onOpenIntegration"])
+                            onOpenIntegration: $options.onAutoBodyOpenIntegration,
+                            onSelectObject: $options.onRelatedObjectSelect
+                          }, null, 8 /* PROPS */, ["widget", "showCardTitle", "showActions", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "hideEmpty", "cnRegistry", "availableWidgets", "onGeoSaved", "onOpenIntegration", "onSelectObject"])
                         ])
                       ], 10 /* CLASS, PROPS */, _hoisted_19$8)
                     ]),
@@ -272784,8 +272850,9 @@ function render$1c(_ctx, _cache, $props, $setup, $data, $options) {
                   cnRegistry: $options.cnRegistry,
                   availableWidgets: _ctx.widgets,
                   onGeoSaved: $options.onGeoSaved,
-                  onOpenIntegration: $options.onAutoBodyOpenIntegration
-                }, null, 8 /* PROPS */, ["widget", "showActions", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "hideEmpty", "cnRegistry", "availableWidgets", "onGeoSaved", "onOpenIntegration"])
+                  onOpenIntegration: $options.onAutoBodyOpenIntegration,
+                  onSelectObject: $options.onRelatedObjectSelect
+                }, null, 8 /* PROPS */, ["widget", "showActions", "objectId", "object", "objectType", "schemaObject", "register", "schema", "store", "surface", "integrationContext", "hideEmpty", "cnRegistry", "availableWidgets", "onGeoSaved", "onOpenIntegration", "onSelectObject"])
               ])
             ], 8 /* PROPS */, _hoisted_34$1))
           }), 128 /* KEYED_FRAGMENT */))
@@ -295314,7 +295381,7 @@ var script$s = {
 		},
 	},
 
-	emits: ['layout-change'],
+	emits: ['layout-change', 'select-object'],
 
 	data() {
 		return {
@@ -295524,6 +295591,20 @@ var script$s = {
 	},
 
 	methods: {
+		/**
+		 * Pass a related widget's object click up; the page opens the object.
+		 *
+		 * @param {object} raw The clicked object.
+		 * @return {void}
+		 */
+		onSelectObject(raw) {
+			/**
+			 * @event select-object An object row in a related widget of this grid was clicked. Payload is the raw object.
+			 * @type {object}
+			 */
+			this.$emit('select-object', raw);
+		},
+
 		// Expose the shared grid helpers to the template.
 		cnGridCellStyle,
 		hasGridRow,
@@ -295618,7 +295699,7 @@ function render$s(_ctx, _cache, $props, $setup, $data, $options) {
               "gs-h": widget.gridHeight
             }, [
               vue$1.createElementVNode("div", _hoisted_4$v, [
-                (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent(widget.component), vue$1.mergeProps({ ref_for: true }, widget.props), null, 16 /* FULL_PROPS */))
+                (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent(widget.component), vue$1.mergeProps({ ref_for: true }, widget.props, { onSelectObject: $options.onSelectObject }), null, 16 /* FULL_PROPS */, ["onSelectObject"]))
               ])
             ], 8 /* PROPS */, _hoisted_3$w))
           }), 128 /* KEYED_FRAGMENT */))
@@ -295636,7 +295717,7 @@ function render$s(_ctx, _cache, $props, $setup, $data, $options) {
             class: vue$1.normalizeClass(["cn-grid__item", { 'cn-grid__item--row': $options.hasGridRow(widget) }]),
             style: vue$1.normalizeStyle($options.cnGridCellStyle(widget, $options.gridColumns))
           }, [
-            (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent(widget.component), vue$1.mergeProps({ ref_for: true }, widget.props), null, 16 /* FULL_PROPS */))
+            (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent(widget.component), vue$1.mergeProps({ ref_for: true }, widget.props, { onSelectObject: $options.onSelectObject }), null, 16 /* FULL_PROPS */, ["onSelectObject"]))
           ], 6 /* CLASS, STYLE */))
         }), 128 /* KEYED_FRAGMENT */))
       ], 14 /* CLASS, STYLE, PROPS */, _hoisted_5$j))
@@ -296139,6 +296220,53 @@ const defaultPageTypes = {
 	'flow-detail': vue$1.defineAsyncComponent(() => Promise.resolve().then(function () { return CnFlowEditorPage; }).then((m) => m.default)),
 };
 
+/**
+ * OpenRegister registers and schemas already described by id, so a click on
+ * a related object costs at most one request per register or schema for as
+ * long as this module stays loaded (the SPA's lifetime, across page
+ * changes). Keyed by `${kind}:${id}`; a failed lookup is dropped again so the
+ * next click retries it.
+ *
+ * @type {Map<string, Promise<{ id: string, slug: string }>>}
+ */
+const entityDescriptorCache = new Map();
+
+/**
+ * Describe an OpenRegister register or schema (`{ id, slug }`) by its id or
+ * slug, or null when it cannot be fetched. An object's `@self` names its
+ * register and schema by id while a manifest may name them by slug; this is
+ * the bridge. Lazy-imports axios and the router helper like the widgets do.
+ *
+ * @param {'registers'|'schemas'} kind The collection to ask.
+ * @param {string|number} idOrSlug The id (or slug) to describe.
+ * @return {Promise<{ id: string, slug: string }|null>} The descriptor.
+ */
+function describeOpenRegisterEntity(kind, idOrSlug) {
+	const key = `${kind}:${idOrSlug}`;
+	if (!entityDescriptorCache.has(key)) {
+		entityDescriptorCache.set(key, (async () => {
+			try {
+				const [{ default: axios }, { generateUrl }] = await Promise.all([
+					import('@nextcloud/axios'),
+					import('@nextcloud/router'),
+				]);
+				const url = generateUrl('/apps/openregister/api/{kind}/{id}', { kind, id: String(idOrSlug) });
+				const res = await axios.get(url);
+				const data = res && res.data;
+				if (!data || typeof data !== 'object') {
+					throw new Error(`no descriptor for ${key}`)
+				}
+				return { id: String(data.id ?? idOrSlug), slug: String(data.slug ?? '') }
+			} catch (error) {
+				// One failed request must not pin every later click to nowhere.
+				entityDescriptorCache.delete(key);
+				throw error
+			}
+		})());
+	}
+	return entityDescriptorCache.get(key).catch(() => null)
+}
+
 /** Recognised fixed slot names for v2 manifests. */
 const KNOWN_SLOTS = new Set(['body', 'sidebar', 'header-actions', 'footer', 'modal']);
 
@@ -297666,6 +297794,92 @@ var script$r = {
 			})
 		},
 
+		/**
+		 * Open the detail page of an object clicked in a Related widget —
+		 * reaching here as `CnDetailPage`'s `related-object-click`, or as
+		 * `CnWidgetGrid`'s `select-object` on a v2 widget-grid page. Nothing
+		 * listened to either, so the rows looked like links and went nowhere.
+		 *
+		 * @param {object} raw The clicked object as the Related widget holds it.
+		 * @return {Promise<void>}
+		 */
+		async onRelatedObjectOpen(raw) {
+			const target = await this.relatedObjectTarget(raw);
+			if (target) {
+				this.$router.push(target).catch(() => {});
+			}
+		},
+
+		/**
+		 * Where a related object opens: the first `type: 'detail'` page bound
+		 * to the object's register and schema, with the id in whichever param
+		 * that page's route declares. The object's `@self` names register and
+		 * schema by id and a manifest may name them by slug, so a miss on the
+		 * literal pair describes both (one request each, cached) and matches
+		 * again. Null, silently, when there is no router or the object carries
+		 * no register, schema or id (nothing to open); null with a warning,
+		 * like a dead row click, when no detail page matches or the router
+		 * lacks the route.
+		 *
+		 * @param {object} raw The clicked object.
+		 * @return {Promise<object|null>} The router location, or null.
+		 */
+		async relatedObjectTarget(raw) {
+			const router = this.$router;
+			if (!router || !raw || typeof raw !== 'object') {
+				return null
+			}
+			const self = raw['@self'] || {};
+			const id = raw.id ?? self.id ?? self.uuid ?? raw.uuid;
+			const register = self.register ?? raw.register;
+			const schema = self.schema ?? raw.schema;
+			const missing = (v) => v === undefined || v === null || v === '';
+			if (missing(id) || missing(register) || missing(schema)) {
+				return null
+			}
+			let page = this.detailPageFor([String(register)], [String(schema)]);
+			if (!page) {
+				const [reg, sch] = await Promise.all([
+					describeOpenRegisterEntity('registers', register),
+					describeOpenRegisterEntity('schemas', schema),
+				]);
+				page = this.detailPageFor(
+					[String(register), reg?.id, reg?.slug].filter(Boolean),
+					[String(schema), sch?.id, sch?.slug].filter(Boolean),
+				);
+			}
+			if (!page) {
+				// eslint-disable-next-line no-console
+				console.warn(`[CnPageRenderer] No detail page is bound to register "${register}" and schema "${schema}", so related object "${id}" opens nowhere.`);
+				return null
+			}
+			if (this.routeNameIsKnown(page.id) === false) {
+				// eslint-disable-next-line no-console
+				console.warn(`[CnPageRenderer] Detail page "${page.id}" is not a route the router has, so related object "${id}" opens nowhere.`);
+				return null
+			}
+			const path = page.route ?? routePathFor(router, page.id);
+			return { name: page.id, params: buildRouteParams(path, id, this.$route?.params) }
+		},
+
+		/**
+		 * The first `type: 'detail'` page whose register and schema are both
+		 * among the given names (ids or slugs, compared as strings).
+		 *
+		 * @param {Array<string>} registerNames Names the register goes by.
+		 * @param {Array<string>} schemaNames Names the schema goes by.
+		 * @return {object|null} The page, or null.
+		 */
+		detailPageFor(registerNames, schemaNames) {
+			for (const page of this.detailPageByRegisterSchema.values()) {
+				const cfg = page.config || {};
+				if (registerNames.includes(String(cfg.register)) && schemaNames.includes(String(cfg.schema))) {
+					return page
+				}
+			}
+			return null
+		},
+
 		/**
 		 * Whether the router has a route by this name.
 		 *
@@ -298075,14 +298289,16 @@ function render$r(_ctx, _cache, $props, $setup, $data, $options) {
                         key: 0,
                         widgets: $options.widgetsBySlot.get('body'),
                         editable: $options.bodyEditable,
-                        slotName: "body"
-                      }, null, 8 /* PROPS */, ["widgets", "editable"]))
+                        slotName: "body",
+                        onSelectObject: $options.onRelatedObjectOpen
+                      }, null, 8 /* PROPS */, ["widgets", "editable", "onSelectObject"]))
                     : ($options.resolvedComponent)
                       ? (vue$1.openBlock(), vue$1.createBlock(vue$1.resolveDynamicComponent($options.resolvedComponent), vue$1.mergeProps({ key: $options.pageRenderKey }, { ..._ctx.$attrs, ...$options.resolvedProps }, {
                           onView: $options.onRowOpen,
                           onRowClick: $options.onRowOpen,
                           onRowAuxClick: $options.onRowOpen,
                           onEditOpen: $options.onRowOpen,
+                          onRelatedObjectClick: $options.onRelatedObjectOpen,
                           onConfigure: _cache[0] || (_cache[0] = $event => ($data.showConfigModal = true))
                         }), vue$1.createSlots({ _: 2 /* DYNAMIC */ }, [
                           vue$1.renderList($options.resolvedSlotEntries, (entry) => {
@@ -298118,42 +298334,47 @@ function render$r(_ctx, _cache, $props, $setup, $data, $options) {
                                 key: "0"
                               }
                             : undefined
-                        ]), 1040 /* FULL_PROPS, DYNAMIC_SLOTS */, ["onView", "onRowClick", "onRowAuxClick", "onEditOpen"]))
+                        ]), 1040 /* FULL_PROPS, DYNAMIC_SLOTS */, ["onView", "onRowClick", "onRowAuxClick", "onEditOpen", "onRelatedObjectClick"]))
                       : vue$1.createCommentVNode("v-if", true),
                   ($options.widgetsBySlot.has('header-actions'))
                     ? (vue$1.openBlock(), vue$1.createBlock(_component_CnWidgetGrid, {
                         key: 2,
                         widgets: $options.widgetsBySlot.get('header-actions'),
-                        slotName: "header-actions"
-                      }, null, 8 /* PROPS */, ["widgets"]))
+                        slotName: "header-actions",
+                        onSelectObject: $options.onRelatedObjectOpen
+                      }, null, 8 /* PROPS */, ["widgets", "onSelectObject"]))
                     : vue$1.createCommentVNode("v-if", true),
                   ($options.widgetsBySlot.has('footer'))
                     ? (vue$1.openBlock(), vue$1.createBlock(_component_CnWidgetGrid, {
                         key: 3,
                         widgets: $options.widgetsBySlot.get('footer'),
-                        slotName: "footer"
-                      }, null, 8 /* PROPS */, ["widgets"]))
+                        slotName: "footer",
+                        onSelectObject: $options.onRelatedObjectOpen
+                      }, null, 8 /* PROPS */, ["widgets", "onSelectObject"]))
                     : vue$1.createCommentVNode("v-if", true),
                   ($options.widgetsBySlot.has('modal'))
                     ? (vue$1.openBlock(), vue$1.createBlock(_component_CnWidgetGrid, {
                         key: 4,
                         widgets: $options.widgetsBySlot.get('modal'),
-                        slotName: "modal"
-                      }, null, 8 /* PROPS */, ["widgets"]))
+                        slotName: "modal",
+                        onSelectObject: $options.onRelatedObjectOpen
+                      }, null, 8 /* PROPS */, ["widgets", "onSelectObject"]))
                     : vue$1.createCommentVNode("v-if", true),
                   ($options.widgetsBySlot.has('sidebar') && $options.pageSidebarVisibleValue)
                     ? (vue$1.openBlock(), vue$1.createBlock(_component_CnWidgetGrid, {
                         key: 5,
                         widgets: $options.widgetsBySlot.get('sidebar'),
-                        slotName: "sidebar"
-                      }, null, 8 /* PROPS */, ["widgets"]))
+                        slotName: "sidebar",
+                        onSelectObject: $options.onRelatedObjectOpen
+                      }, null, 8 /* PROPS */, ["widgets", "onSelectObject"]))
                     : vue$1.createCommentVNode("v-if", true),
                   (vue$1.openBlock(true), vue$1.createElementBlock(vue$1.Fragment, null, vue$1.renderList($options.dynamicSlotKeys, (dynamicSlot) => {
                     return (vue$1.openBlock(), vue$1.createBlock(_component_CnWidgetGrid, {
                       key: dynamicSlot,
                       widgets: $options.widgetsBySlot.get(dynamicSlot),
-                      slotName: dynamicSlot
-                    }, null, 8 /* PROPS */, ["widgets", "slotName"]))
+                      slotName: dynamicSlot,
+                      onSelectObject: $options.onRelatedObjectOpen
+                    }, null, 8 /* PROPS */, ["widgets", "slotName", "onSelectObject"]))
                   }), 128 /* KEYED_FRAGMENT */))
                 ], 64 /* STABLE_FRAGMENT */))
               : ($options.resolvedComponent)
@@ -298162,6 +298383,7 @@ function render$r(_ctx, _cache, $props, $setup, $data, $options) {
                     onRowClick: $options.onRowOpen,
                     onRowAuxClick: $options.onRowOpen,
                     onEditOpen: $options.onRowOpen,
+                    onRelatedObjectClick: $options.onRelatedObjectOpen,
                     onConfigure: _cache[1] || (_cache[1] = $event => ($data.showConfigModal = true))
                   }), vue$1.createSlots({ _: 2 /* DYNAMIC */ }, [
                     vue$1.renderList($options.resolvedSlotEntries, (entry) => {
@@ -298197,7 +298419,7 @@ function render$r(_ctx, _cache, $props, $setup, $data, $options) {
                           key: "0"
                         }
                       : undefined
-                  ]), 1040 /* FULL_PROPS, DYNAMIC_SLOTS */, ["onView", "onRowClick", "onRowAuxClick", "onEditOpen"]))
+                  ]), 1040 /* FULL_PROPS, DYNAMIC_SLOTS */, ["onView", "onRowClick", "onRowAuxClick", "onEditOpen", "onRelatedObjectClick"]))
                 : vue$1.createCommentVNode("v-if", true),
         (!$options.hasRenderableBody)
           ? (vue$1.openBlock(), vue$1.createElementBlock("div", _hoisted_2$A, [
@@ -304521,6 +304743,136 @@ script$j.render = render$j;
 script$j.__file = "src/components/CnAiCompanion/CnAiCompanion.vue";
 const __sfc_main$j = script$j;
 
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The label a person reads for one notification rule in their settings.
+ *
+ * A rule is declared in a schema's `x-openregister-notifications` map under a
+ * KEY (`caseAssigned`, `clientUpdated`, `onCreate`). The key is an identifier
+ * for a developer. The settings pane used to print it as is, so a person saw
+ * "substitutionRegisteredForSubstitute" next to a switch and had to guess.
+ *
+ * The label is taken from the first source that has one, most specific first:
+ *
+ *   1. the rule's own words, when OpenRegister passes them on the preference
+ *      entry (`label`, then `title`), as a plain string or a per-locale map
+ *      like the dialect's `subject` (`{ "nl": "…", "en": "…" }`);
+ *   2. the app's own label for the rule, from the `labels` map the app hands
+ *      to CnAppRoot (`notificationLabels`), keyed `<schema>.<key>` or `<key>`;
+ *   3. the library's wording for the generic object-event keys;
+ *   4. the key made readable: `caseAssigned` becomes "Case assigned".
+ *
+ * The rule's `subject` is used only when it carries no `{{placeholder}}`: it
+ * is the notification TITLE template, and "Case "{{title}}" assigned to you"
+ * reads worse as a setting than the readable key does.
+ *
+ * Pure: no store, no fetch, no Vue.
+ *
+ * @spec openspec/changes/notification-rule-labels-and-runtime-version/specs/notification-preferences/spec.md
+ */
+
+/**
+ * Pick the string for the current language out of a string or per-locale map.
+ *
+ * @param {string|object|null|undefined} value A string, or `{ nl, en, … }`.
+ * @param {string} [language] The current language, e.g. `nl` or `de_DE`.
+ * @return {string} The resolved text, or '' when there is none.
+ */
+function resolveLocalised(value, language = 'en') {
+	if (typeof value === 'string') {
+		return value.trim()
+	}
+	if (!value || typeof value !== 'object' || Array.isArray(value)) {
+		return ''
+	}
+	const lang = String(language || 'en');
+	const base = lang.split(/[-_]/)[0];
+	for (const candidate of [lang, base, 'en']) {
+		if (typeof value[candidate] === 'string' && value[candidate].trim() !== '') {
+			return value[candidate].trim()
+		}
+	}
+	const first = Object.values(value).find((text) => typeof text === 'string' && text.trim() !== '');
+	return first ? first.trim() : ''
+}
+
+/**
+ * Make a rule key readable: split camelCase, snake_case and kebab-case into
+ * words, keep acronyms, and capitalise only the first word.
+ *
+ * `caseAssigned` → "Case assigned", `object_created` → "Object created",
+ * `newBRPRecord` → "New BRP record".
+ *
+ * @param {string} key The rule key.
+ * @return {string} A readable sentence-case label, or the key when it has no words.
+ */
+function humaniseRuleKey(key) {
+	const words = String(key || '')
+		.replace(/([a-z0-9])([A-Z])/g, '$1 $2')
+		.replace(/([A-Z]+)([A-Z][a-z])/g, '$1 $2')
+		.split(/[\s_\-.]+/)
+		.filter(Boolean);
+	if (words.length === 0) {
+		return String(key || '')
+	}
+	return words
+		.map((word, index) => {
+			const isAcronym = word.length > 1 && word === word.toUpperCase() && /[A-Z]/.test(word);
+			if (isAcronym) {
+				return word
+			}
+			const lower = word.toLowerCase();
+			return index === 0 ? lower.charAt(0).toUpperCase() + lower.slice(1) : lower
+		})
+		.join(' ')
+}
+
+/**
+ * The label for one preference entry.
+ *
+ * @param {object} entry A preference entry: `{ schema, notification, label?, title?, subject? }`.
+ * @param {object} [options] Where else a label may come from.
+ * @param {object} [options.labels] App-supplied labels keyed `<schema>.<key>` or `<key>`;
+ *   values are strings or per-locale maps.
+ * @param {object} [options.known] Library wording for generic keys, keyed by rule key.
+ * @param {string} [options.language] The current language.
+ * @return {string} The label to show.
+ */
+function notificationRuleLabel(entry, { labels = {}, known = {}, language = 'en' } = {}) {
+	const key = String(entry?.notification ?? '');
+	const schema = String(entry?.schema ?? '');
+
+	for (const field of ['label', 'title']) {
+		const own = resolveLocalised(entry?.[field], language);
+		if (own) {
+			return own
+		}
+	}
+
+	const map = labels && typeof labels === 'object' ? labels : {};
+	for (const lookup of [schema ? `${schema}.${key}` : '', key]) {
+		if (lookup && Object.hasOwn(map, lookup)) {
+			const fromApp = resolveLocalised(map[lookup], language);
+			if (fromApp) {
+				return fromApp
+			}
+		}
+	}
+
+	if (known && typeof known[key] === 'string' && known[key]) {
+		return known[key]
+	}
+
+	const subject = resolveLocalised(entry?.subject, language);
+	if (subject && !subject.includes('{{')) {
+		return subject
+	}
+
+	return humaniseRuleKey(key)
+}
+
 const PREFS_PATH = '/apps/openregister/api/notification-preferences';
 
 var script$i = {
@@ -304544,6 +304896,28 @@ var script$i = {
 		 * than an always-empty pane.
 		 */
 		cnAppId: { default: () => '' },
+		/**
+		 * App-supplied labels for its notification rules, provided by the
+		 * CnAppRoot ancestor from its `notificationLabels` prop. Keyed
+		 * `<schema>.<key>` or `<key>`.
+		 */
+		cnNotificationLabels: { default: () => ({}) },
+	},
+
+	props: {
+		/**
+		 * Labels for the notification rules, keyed `<schema>.<key>` or
+		 * `<key>`; values are strings or per-locale maps (`{ nl, en }`).
+		 * Optional: inside CnAppRoot the app's `notificationLabels` arrive by
+		 * inject, and a rule without a label still reads as words, never as
+		 * its raw key. A prop given here wins over the injected map.
+		 *
+		 * @spec openspec/changes/notification-rule-labels-and-runtime-version/specs/notification-preferences/spec.md
+		 */
+		labels: {
+			type: Object,
+			default: null,
+		},
 	},
 
 	data() {
@@ -304669,18 +305043,43 @@ var script$i = {
 		},
 
 		/**
-		 * Human-readable label for a notification key, falling back to the key.
+		 * Human-readable label for a notification rule. Never the raw key: the
+		 * rule's own label, then the app's, then the library's wording for the
+		 * generic keys, then the key split into words.
 		 *
-		 * @param {string} key The notification annotation key.
+		 * @param {object} entry The preference row.
 		 * @return {string} A display label.
+		 *
+		 * @spec openspec/changes/notification-rule-labels-and-runtime-version/specs/notification-preferences/spec.md
 		 */
-		notificationLabel(key) {
+		notificationLabel(entry) {
 			const known = {
 				object_created: l10n.translate('nextcloud-vue', 'When an item is created'),
 				object_updated: l10n.translate('nextcloud-vue', 'When an item is updated'),
 				object_transitioned: l10n.translate('nextcloud-vue', 'When an item is assigned or changes status'),
 			};
-			return known[key] || key
+			const language = this.currentLanguage();
+			const injected = typeof this.cnNotificationLabels === 'function'
+				? this.cnNotificationLabels()
+				: this.cnNotificationLabels;
+			return notificationRuleLabel(entry, {
+				labels: { ...(injected || {}), ...(this.labels || {}) },
+				known,
+				language,
+			})
+		},
+
+		/**
+		 * The person's language, `en` when it cannot be read.
+		 *
+		 * @return {string} The language code.
+		 */
+		currentLanguage() {
+			try {
+				return (typeof l10n.getLanguage === 'function' && l10n.getLanguage()) || 'en'
+			} catch {
+				return 'en'
+			}
 		},
 
 		/**
@@ -304770,7 +305169,7 @@ function render$i(_ctx, _cache, $props, $setup, $data, $options) {
                             "onUpdate:modelValue": $event => ($options.onToggle(entry, $event))
                           }, {
                             default: vue$1.withCtx(() => [
-                              vue$1.createTextVNode(vue$1.toDisplayString($options.notificationLabel(entry.notification)), 1 /* TEXT */)
+                              vue$1.createTextVNode(vue$1.toDisplayString($options.notificationLabel(entry)), 1 /* TEXT */)
                             ]),
                             _: 2 /* DYNAMIC */
                           }, 1032 /* PROPS, DYNAMIC_SLOTS */, ["modelValue", "disabled", "onUpdate:modelValue"]),
@@ -306588,6 +306987,18 @@ var script$f = {
 			 * wiring.
 			 */
 			cnAppId: this.appId,
+			/**
+			 * The app's labels for its notification rules, read by the
+			 * notification-preferences pane in the user-settings modal. A
+			 * getter so a late prop update is still seen by a pane that
+			 * mounts after it.
+			 *
+			 * @spec openspec/changes/notification-rule-labels-and-runtime-version/specs/notification-preferences/spec.md
+			 */
+			get cnNotificationLabels() {
+				return self.notificationLabels || {}
+			},
+
 			/**
 			 * Target repo slug for the in-product feature-request deep
 			 * link (e.g. `ConductionNL/pipelinq`). Read from the
@@ -307003,6 +307414,23 @@ var script$f = {
 			default: (key) => key,
 		},
 
+		/**
+		 * Labels for the app's notification rules, shown in the
+		 * user-settings notification pane instead of the rule keys. Keyed
+		 * `<schema>.<key>` (or just `<key>`); values are already translated
+		 * strings, e.g. `{ 'case.caseAssigned': t('dossiq', 'A case is
+		 * assigned to me') }`, or per-locale maps `{ nl, en }`. A rule's own
+		 * `label` from OpenRegister wins; a rule with no label anywhere reads
+		 * as its key split into words, never as the raw key.
+		 *
+		 * @type {{[key: string]: (string|object)}}
+		 * @spec openspec/changes/notification-rule-labels-and-runtime-version/specs/notification-preferences/spec.md
+		 */
+		notificationLabels: {
+			type: Object,
+			default: () => ({}),
+		},
+
 		/**
 		 * List of permission strings the current user holds. Forwarded
 		 * to CnAppNav's permission filter.
@@ -349573,6 +350001,7 @@ exports.getRegisterApiUrl = getRegisterApiUrl;
 exports.getSchemaApiUrl = getSchemaApiUrl;
 exports.getSharedRegistry = getSharedRegistry;
 exports.getWidgetTypeEntry = getWidgetTypeEntry;
+exports.humaniseRuleKey = humaniseRuleKey;
 exports.installIntegrationRegistry = installIntegrationRegistry;
 exports.installModalStack = installModalStack;
 exports.integrations = integrations;
@@ -349604,6 +350033,7 @@ exports.mergePages = mergePages;
 exports.mergeUserLayout = mergeUserLayout;
 exports.networkError = networkError;
 exports.notesIntegration = notesIntegration;
+exports.notificationRuleLabel = notificationRuleLabel;
 exports.offlineCollection = index;
 exports.openRowTarget = openRowTarget;
 exports.openprojectIntegration = openprojectIntegration;