@conduction/nextcloud-vue 2.73.0 → 2.73.1

package/dist/nextcloud-vue.cjs.js.map

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/nextcloud-vue.cjs.js.map
-size: 35692438 bytes
-sha256: 9054c705b23062b8dca68969cf561ce87cf95a1f2c6dea28e8e5cb78a2ca437c
+size: 35731122 bytes
+sha256: 2f00e1767fdb1c72a109ba42b159ca43fb36fbd6a93a33087f4c8529da77b80b

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.73.0",
+  "version": "2.73.1",
   "description": "Shared Vue component library for Conduction Nextcloud apps — complements @nextcloud/vue with higher-level components, OpenRegister integration, and NL Design System support",
   "homepage": "https://github.com/ConductionNL/nextcloud-vue#readme",
   "bugs": {

package/src/components/CnAppRoot/CnAppRoot.md

@@ -78,6 +78,7 @@ With loading state, custom components, translate, permissions, and custom page t
 | `cellWidgets` | Object | No | `{}` | Cell-widget registry — map of widget-id → Vue component, rendered for a column that declares `pages[].config.columns[].widget`. The component receives `{ value, row, property, formatted, ...widgetProps }`. The library ships one built-in id, `"badge"` (renders `CnStatusBadge`); consumer entries cover everything else (status pills with custom colour maps, inline toggles, link cells, …). Provided to descendant `CnDataTable` / `CnCellRenderer` as `cnCellWidgets`. See `docs/migrating-to-manifest.md` → "Column widgets". |
 | `kbSearchProviders` | Object | No | `{}` | Pluggable knowledge-base search providers (#91 Wave 3) — map of provider-key → `{ search(query, opts), externalOpen? }`, merged OVER the library built-in `default` (endpoint) provider and provided to descendant `CnKbSearchWidget` as `cnKbSearchProviders`. A `kb-search` widget selects its provider via `content.provider`; an app talking to a bespoke KB backend (the xwiki proxy) registers its client here — the library ships only the seam. |
 | `translate` | Function | No | `key => key` | Translate function from the consuming app, typically `(key) => t(appId, key)`. Provided to descendants as `cnTranslate` |
+| `notificationLabels` | Object | No | `{}` | Labels for the app's notification rules in the user-settings notification pane, keyed `<schema>.<key>` or `<key>`; values are translated strings or `{ nl, en }` maps. A rule without a label reads as its key split into words ("Case assigned"), never as the raw key. Provided to descendants as `cnNotificationLabels` |
 | `permissions` | Array | No | `[]` | Permission strings for the current user; forwarded to `CnAppNav` for menu filtering |
 | `pageTypes` | Object | No | `null` | Page-type registry map (`type → component`). Falls back to the library's `defaultPageTypes`. Extend with `{ ...defaultPageTypes, report: MyReportPage }` |
 | `userSettingsTitle` | String | No | `''` | Title shown at the top of the hosted `NcAppSettingsDialog`. Empty (the default) resolves to `translate('User settings')`. Override per app to brand the modal (e.g. `'Decidiq preferences'`). |

package/src/components/CnAppRoot/CnAppRoot.vue

@@ -996,6 +996,18 @@ export default {
 			 * 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
@@ -1411,6 +1423,23 @@ export default {
 			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.

package/src/components/CnDetailPage/CnDetailPage.vue

@@ -454,7 +454,8 @@
 						:cnRegistry="cnRegistry"
 						:availableWidgets="widgets"
 						@geoSaved="onGeoSaved"
-						@openIntegration="onAutoBodyOpenIntegration" />
+						@openIntegration="onAutoBodyOpenIntegration"
+						@selectObject="onRelatedObjectSelect" />
 				</slot>
 			</div>
 		</div>
@@ -764,7 +765,8 @@
 								:cnRegistry="cnRegistry"
 								:availableWidgets="bodyGridWidgets"
 								@geoSaved="onGeoSaved"
-								@openIntegration="onAutoBodyOpenIntegration" />
+								@openIntegration="onAutoBodyOpenIntegration"
+								@selectObject="onRelatedObjectSelect" />
 						</slot>
 					</div>
 				</template>
@@ -975,7 +977,8 @@
 						:cnRegistry="cnRegistry"
 						:availableWidgets="widgets"
 						@geoSaved="onGeoSaved"
-						@openIntegration="onAutoBodyOpenIntegration" />
+						@openIntegration="onAutoBodyOpenIntegration"
+						@selectObject="onRelatedObjectSelect" />
 				</slot>
 			</div>
 		</aside>
@@ -2334,6 +2337,7 @@ export default {
 		'layout-change',
 		'open-integration',
 		'refresh',
+		'related-object-click',
 		'related-row-click',
 		'relation-linked',
 		'request-feature',
@@ -4315,6 +4319,23 @@ export default {
 			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),

package/src/components/CnDetailWidgetHost/CnDetailWidgetHost.vue

@@ -114,7 +114,8 @@
 			:includeGroups="content.groups || []"
 			:hideSingleTabTitle="content.hideSingleTabTitle !== false"
 			:showTotalCount="content.showTotalCount !== false"
-			@openIntegration="onOpenIntegration" />
+			@openIntegration="onOpenIntegration"
+			@selectObject="onSelectObject" />
 
 		<!-- `type: 'object-geo'` — view/edit the object's `@self.geo` on a map. -->
 		<CnObjectGeoWidget
@@ -183,7 +184,8 @@
 			<component
 				:is="renderer"
 				ref="renderer"
-				v-bind="rendererProps" />
+				v-bind="rendererProps"
+				@selectObject="onSelectObject" />
 		</CnWidgetWrapper>
 
 		<!-- Registry "card" widgets (stat / gauge / delta) render bare tile
@@ -218,7 +220,8 @@
 			:is="renderer"
 			v-else-if="renderer"
 			ref="renderer"
-			v-bind="rendererProps" />
+			v-bind="rendererProps"
+			@selectObject="onSelectObject" />
 
 		<!-- No renderer resolves: render nothing, which is what CnDetailPage has
 		     always done here. Surfacing an "unknown widget" box instead would be
@@ -501,7 +504,7 @@ export default {
 		},
 	},
 
-	emits: ['geo-saved', 'open-integration'],
+	emits: ['geo-saved', 'open-integration', 'select-object'],
 
 	setup() {
 		// Every integration component this host renders goes through the
@@ -1006,6 +1009,21 @@ export default {
 			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.

package/src/components/CnIndexPage/CnIndexPage.vue

@@ -731,7 +731,7 @@
 					:currentPageSize="effectivePagination.limit || 20"
 					class="cn-index-page__pagination"
 					@pageChanged="onPageEvent"
-					@pageSizeChanged="$emit('page-size-changed', $event)" />
+					@pageSizeChanged="onPageSizeEvent" />
 			</div>
 
 			<!-- The open record, beside the list on a wide screen and instead
@@ -1057,7 +1057,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.
@@ -5482,6 +5482,21 @@ export default {
 			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}

package/src/components/CnNotificationPreferences/CnNotificationPreferences.vue

@@ -32,7 +32,7 @@
 							:modelValue="entry.enabled"
 							:disabled="entry.saving"
 							@update:modelValue="onToggle(entry, $event)">
-							{{ notificationLabel(entry.notification) }}
+							{{ notificationLabel(entry) }}
 						</NcCheckboxRadioSwitch>
 						<NcButton v-if="entry.source === 'user-override'"
 							variant="tertiary"
@@ -49,7 +49,7 @@
 
 <script>
 import axios from '@nextcloud/axios'
-import { translate as t } from '@nextcloud/l10n'
+import { getLanguage, translate as t } from '@nextcloud/l10n'
 import { generateUrl } from '@nextcloud/router'
 /**
  * CnNotificationPreferences
@@ -82,6 +82,7 @@ import { generateUrl } from '@nextcloud/router'
 import { NcAppSettingsSection, NcButton, NcCheckboxRadioSwitch, NcEmptyContent, NcLoadingIcon } from '@nextcloud/vue'
 import BellOffOutline from 'vue-material-design-icons/BellOffOutline.vue'
 import BellOutline from 'vue-material-design-icons/BellOutline.vue'
+import { notificationRuleLabel } from '../../utils/notificationRuleLabel.js'
 
 const PREFS_PATH = '/apps/openregister/api/notification-preferences'
 
@@ -106,6 +107,28 @@ export default {
 		 * 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() {
@@ -231,18 +254,43 @@ export default {
 		},
 
 		/**
-		 * 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: t('nextcloud-vue', 'When an item is created'),
 				object_updated: t('nextcloud-vue', 'When an item is updated'),
 				object_transitioned: t('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 getLanguage === 'function' && getLanguage()) || 'en'
+			} catch {
+				return 'en'
+			}
 		},
 
 		/**

package/src/components/CnPageRenderer/CnPageRenderer.vue

@@ -120,7 +120,8 @@
 				v-if="widgetsBySlot.has('body')"
 				:widgets="widgetsBySlot.get('body')"
 				:editable="bodyEditable"
-				slotName="body" />
+				slotName="body"
+				@selectObject="onRelatedObjectOpen" />
 			<component
 				:is="resolvedComponent"
 				v-else-if="resolvedComponent"
@@ -130,6 +131,7 @@
 				@rowClick="onRowOpen"
 				@rowAuxClick="onRowOpen"
 				@editOpen="onRowOpen"
+				@relatedObjectClick="onRelatedObjectOpen"
 				@configure="showConfigModal = true">
 				<!-- This `<template v-for>` defines dynamic SLOTS, not a
 				     rendered list, so the rule's advice is inverted here:
@@ -173,27 +175,32 @@
 			<CnWidgetGrid
 				v-if="widgetsBySlot.has('header-actions')"
 				:widgets="widgetsBySlot.get('header-actions')"
-				slotName="header-actions" />
+				slotName="header-actions"
+				@selectObject="onRelatedObjectOpen" />
 			<!-- footer slot -->
 			<CnWidgetGrid
 				v-if="widgetsBySlot.has('footer')"
 				:widgets="widgetsBySlot.get('footer')"
-				slotName="footer" />
+				slotName="footer"
+				@selectObject="onRelatedObjectOpen" />
 			<!-- modal slot -->
 			<CnWidgetGrid
 				v-if="widgetsBySlot.has('modal')"
 				:widgets="widgetsBySlot.get('modal')"
-				slotName="modal" />
+				slotName="modal"
+				@selectObject="onRelatedObjectOpen" />
 			<!-- sidebar slot (gated by cnPageSidebarVisible) -->
 			<CnWidgetGrid
 				v-if="widgetsBySlot.has('sidebar') && pageSidebarVisibleValue"
 				:widgets="widgetsBySlot.get('sidebar')"
-				slotName="sidebar" />
+				slotName="sidebar"
+				@selectObject="onRelatedObjectOpen" />
 			<!-- dynamic tab:* and section:* slots -->
 			<template v-for="dynamicSlot in dynamicSlotKeys" :key="dynamicSlot">
 				<CnWidgetGrid
 					:widgets="widgetsBySlot.get(dynamicSlot)"
-					:slotName="dynamicSlot" />
+					:slotName="dynamicSlot"
+					@selectObject="onRelatedObjectOpen" />
 			</template>
 		</template>
 
@@ -206,6 +213,7 @@
 			@rowClick="onRowOpen"
 			@rowAuxClick="onRowOpen"
 			@editOpen="onRowOpen"
+			@relatedObjectClick="onRelatedObjectOpen"
 			@configure="showConfigModal = true">
 			<!-- Dynamic slot definition, not a rendered list — see the note on
 			     the identical block above. -->
@@ -300,6 +308,53 @@ import { resolveRouteSentinels } from '../../utils/resolveRouteSentinels.js'
 import { parseSortKeys } from '../../utils/routeFilters.js'
 import { buildRouteParams, routePathFor } from '../../utils/routeParams.js'
 import { isNewTabHandled } from '../../utils/rowAuxClick.js'
+
+/**
+ * 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)
+}
 import { CnMassExportDialog } from '../CnMassExportDialog/index.js'
 import { defaultPageTypes } from './pageTypes.js'
 
@@ -1830,6 +1885,92 @@ export default {
 			})
 		},
 
+		/**
+		 * 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.
 		 *

package/src/components/CnTabsWidget/CnTabsWidget.vue

@@ -88,7 +88,8 @@
 					:integrationContext="integrationContext"
 					:cnRegistry="cnRegistry"
 					@geoSaved="onGeoSaved"
-					@openIntegration="onOpenIntegration" />
+					@openIntegration="onOpenIntegration"
+					@selectObject="onSelectObject" />
 				<NcEmptyContent v-else :name="missingLabel(entry)" />
 			</CnTab>
 		</CnTabs>
@@ -357,7 +358,7 @@ export default {
 		},
 	},
 
-	emits: ['geo-saved', 'open-integration'],
+	emits: ['geo-saved', 'open-integration', 'select-object'],
 
 	data() {
 		return {
@@ -530,6 +531,20 @@ export default {
 			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.

package/src/components/CnWidgetGrid/CnWidgetGrid.vue

@@ -39,7 +39,8 @@
 				<div class="grid-stack-item-content">
 					<component
 						:is="widget.component"
-						v-bind="widget.props" />
+						v-bind="widget.props"
+						@selectObject="onSelectObject" />
 				</div>
 			</div>
 		</div>
@@ -58,7 +59,8 @@
 				:style="cnGridCellStyle(widget, gridColumns)">
 				<component
 					:is="widget.component"
-					v-bind="widget.props" />
+					v-bind="widget.props"
+					@selectObject="onSelectObject" />
 			</div>
 		</template>
 	</div>
@@ -161,7 +163,7 @@ export default {
 		},
 	},
 
-	emits: ['layout-change'],
+	emits: ['layout-change', 'select-object'],
 
 	data() {
 		return {
@@ -371,6 +373,20 @@ export default {
 	},
 
 	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,

package/src/index.js

@@ -476,6 +476,8 @@ export {
 } from './utils/folderCustomization.js'
 export { currentTheme, useCurrentTheme } from './composables/useCurrentTheme.js'
 export { ROADMAP_LABEL_BLOCKLIST } from './utils/roadmapLabelBlocklist.js'
+// The words a person reads for a notification rule key (never the raw key).
+export { humaniseRuleKey, notificationRuleLabel } from './utils/notificationRuleLabel.js'
 
 // Shared field validators. These are UX affordances that run in the browser —
 // they do NOT replace server-side validation, which stays authoritative at the