@conduction/nextcloud-vue 2.56.0-beta.11 → 2.56.0-beta.13

package/src/components/CnAppRoot/CnAppRoot.md

@@ -203,3 +203,7 @@ Static-manifest apps use `useAppManifest('myapp', bundledManifest)`, which fetch
 | `softDependencyNotices` | Boolean | `false` | **Deprecated.** Restores the in-shell orange notices, one per unresolved optional dependency. Off by default: they stacked one per optional leaf and pushed the app's own content below the fold, for an audience who cannot act on them. Mount `CnLeafDependencySettings` in admin settings instead. Slated for removal. |
 
 `unresolvedSoftDependencies` is unchanged and still exposed, so an app rendering its own surface from it keeps working.
+
+### Without a navigation (`hideMenu`)
+
+`hideMenu` (default `false`) renders neither the default CnAppNav nor the `#menu` slot, so the content starts at the left edge.

package/src/components/CnAppRoot/CnAppRoot.vue

@@ -199,7 +199,13 @@
 			<!-- @binding {boolean} isOwner Whether the user owns this app (ADR-079 §3). -->
 			<!-- @binding {boolean} isAdmin Whether the user administers the instance; gates the Admin-settings link. -->
 			<!-- @binding {string} appId The app id used to build the Admin-settings target. -->
-			<slot name="menu"
+			<!-- `hideMenu` renders no navigation at all, so the content starts
+			     at the left edge. An EMPTY #menu override cannot do that: an
+			     empty slot falls back to the default CnAppNav (ensureValidVNode),
+			     which is why launchpad passed a hidden empty span. -->
+			<slot
+				v-if="!hideMenu"
+				name="menu"
 				:manifest="menuManifest"
 				:permissions="permissions"
 				:isOwner="isOwner"
@@ -700,6 +706,7 @@ import { BUILT_IN_FORMATTERS } from '../../utils/builtInFormatters.js'
 import { DEFAULT_FORGE, resolveForge } from '../../utils/forge.js'
 import { BUILT_IN_KB_PROVIDERS } from '../../utils/kbSearchProviders.js'
 import { installModalStack, uninstallModalStack } from '../../utils/modalStack.js'
+import { resolveFilterTokens } from '../../utils/resolveFilterTokens.js'
 import { passesContextPredicates } from '../../utils/visibleIfContext.js'
 
 /**
@@ -1049,6 +1056,13 @@ export default {
 			 * the counts.
 			 */
 			cnMenuCounts: this.cnMenuCounts,
+			/**
+			 * Reactive `{ [menuItemId]: number }` totals for menu entries
+			 * whose `count` is an object (`{ register, schema, filter? }`),
+			 * populated by `_hydrateMenuItemCounts()`. Read by
+			 * `CnAppNav.resolveCount()`.
+			 */
+			cnMenuItemCounts: this.cnMenuItemCounts,
 		}
 	},
 
@@ -1192,6 +1206,19 @@ export default {
 			required: true,
 		},
 
+		/**
+		 * Render no app navigation at all: neither the default CnAppNav nor
+		 * the `#menu` slot, so the content starts at the left edge (a start
+		 * page without a menu). Off by default; the navigation renders as it
+		 * always has.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-an-app-root-can-hide-its-menu
+		 */
+		hideMenu: {
+			type: Boolean,
+			default: false,
+		},
+
 		/**
 		 * Human-readable name shown in the Nextcloud top bar. When set it
 		 * overrides the technical `appId` so a virtual app shows its own name
@@ -1707,6 +1734,13 @@ export default {
 			 * picked up by CnAppNav's reactive render.
 			 */
 			cnMenuCounts: reactive({}),
+			/**
+			 * Reactive `{ [menuItemId]: number }` map of filtered totals, one
+			 * per menu entry whose `count` is an object. Provided to
+			 * descendants as `cnMenuItemCounts`. Populated by
+			 * `_hydrateMenuItemCounts()` at mount.
+			 */
+			cnMenuItemCounts: reactive({}),
 			/**
 			 * Open state of the host NcAppSettingsDialog. Toggled
 			 * to `true` by the provided `cnOpenUserSettings()`
@@ -2925,6 +2959,7 @@ export default {
 			this._validateRegistry()
 			this._warnCustomComponentsDeprecation()
 			this._hydrateMenuCounts()
+			this._hydrateMenuItemCounts()
 			return
 		}
 
@@ -2953,6 +2988,7 @@ export default {
 		this._validateRegistry()
 		this._warnCustomComponentsDeprecation()
 		this._hydrateMenuCounts()
+		this._hydrateMenuItemCounts()
 	},
 
 	beforeUnmount() {
@@ -3609,6 +3645,63 @@ export default {
 			})
 		},
 
+		/**
+		 * Fetch the total of every menu entry (top level and children) whose
+		 * `count` is an object `{ register, schema, filter? }`: one
+		 * `GET /api/objects/{register}/{schema}?_limit=1` per entry with the
+		 * filter's tokens (`@me`, `@today`, ...) resolved at fetch time, the
+		 * response `total` written to `cnMenuItemCounts[item.id]`. The
+		 * request goes straight through axios rather than the object store,
+		 * so the index page's whole-schema total in the store is left alone.
+		 * Failures leave the badge unrendered.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-a-menu-entry-counts-a-filtered-list
+		 * @return {void}
+		 * @private
+		 */
+		_hydrateMenuItemCounts() {
+			const collect = (items) => {
+				const out = []
+				for (const item of items ?? []) {
+					const count = item?.count
+					if (count && typeof count === 'object' && typeof item.id === 'string' && count.register && count.schema) {
+						out.push(item)
+					}
+					if (Array.isArray(item?.children)) {
+						out.push(...collect(item.children))
+					}
+				}
+				return out
+			}
+			for (const item of collect(this.manifest?.menu)) {
+				this._fetchMenuItemCount(item)
+			}
+		},
+
+		/**
+		 * One filtered-count request for a menu entry; see
+		 * `_hydrateMenuItemCounts`.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-a-menu-entry-counts-a-filtered-list
+		 * @param {{ id: string, count: { register: string, schema: string, filter?: object } }} item The menu entry.
+		 * @return {Promise<void>}
+		 * @private
+		 */
+		async _fetchMenuItemCount(item) {
+			try {
+				const { register, schema, filter } = item.count
+				const resolved = resolveFilterTokens(filter && typeof filter === 'object' ? filter : {}, {})
+				const url = generateUrl(`/apps/openregister/api/objects/${encodeURIComponent(register)}/${encodeURIComponent(schema)}`)
+				const { data } = await axios.get(url, { params: { _limit: 1, ...resolved } })
+				const total = data?.total
+				if (typeof total === 'number' && total >= 0) {
+					this.cnMenuItemCounts[item.id] = total
+				}
+			} catch {
+				// Non-fatal: the badge stays unrendered.
+			}
+		},
+
 		/**
 		 * Hydrate all menu counts with a single `POST /api/objects/counts`
 		 * (OpenRegister batched-counts endpoint). Distributes each returned

package/src/components/CnAuditTrailCard/CnAuditTrailCard.vue

@@ -69,12 +69,27 @@ export default {
 	components: { CnDetailCard, NcLoadingIcon },
 
 	props: {
-		/** OpenRegister register id (slug or uuid). */
-		register: { type: String, required: true },
-		/** OpenRegister schema id (slug or uuid). */
-		schema: { type: String, required: true },
-		/** Parent object id. */
-		objectId: { type: String, required: true },
+		/** OpenRegister register id (slug or uuid). Optional for `scope: "app"`. */
+		register: { type: String, default: '' },
+		/** OpenRegister schema id (slug or uuid). Optional for `scope: "app"`. */
+		schema: { type: String, default: '' },
+		/** Parent object id. Required for `scope: "object"` (the default); unused for `scope: "app"`. */
+		objectId: { type: String, default: '' },
+		/**
+		 * What the card lists. `object` (the default) is one object's trail
+		 * and needs `register`, `schema` and `objectId`. `app` is the
+		 * app-wide feed: the entries of every object the caller may read
+		 * (OpenRegister's `/audit-trails/readable`), narrowed to `register`
+		 * and `schema` when those are set.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-the-audit-trail-widget-reads-the-app-wide-feed
+		 */
+		scope: {
+			type: String,
+			default: 'object',
+			validator: (value) => ['object', 'app'].includes(value),
+		},
+
 		/** Rendering surface — passed for AD-19 surface fallback consumers. */
 		surface: {
 			type: String,
@@ -116,13 +131,38 @@ export default {
 		displayedEntries() {
 			return this.entries.slice(0, this.maxDisplay)
 		},
+
+		/**
+		 * The path the card reads (prefixed at fetch time), or '' when it has nothing to read: the
+		 * object's own trail, or the app-wide readable feed narrowed to the
+		 * register and schema when set.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-the-audit-trail-widget-reads-the-app-wide-feed
+		 * @return {string}
+		 */
+		fetchUrl() {
+			const params = new URLSearchParams({ limit: String(this.maxDisplay) })
+			if (this.scope === 'app') {
+				if (this.register) {
+					params.set('register', this.register)
+				}
+				if (this.schema) {
+					params.set('schema', this.schema)
+				}
+				return `${this.apiBase}/audit-trails/readable?${params.toString()}`
+			}
+			if (!this.register || !this.schema || !this.objectId) {
+				return ''
+			}
+			return `${this.apiBase}/objects/${this.register}/${this.schema}/${this.objectId}/audit-trail?${params.toString()}`
+		},
 	},
 
 	watch: {
-		objectId: {
+		fetchUrl: {
 			immediate: true,
-			handler(id) {
-				if (id) {
+			handler(url) {
+				if (url) {
 					this.fetchEntries()
 				}
 			},
@@ -130,20 +170,25 @@ export default {
 	},
 
 	methods: {
+		/**
+		 * Read the entries from `fetchUrl`. The readable feed answers
+		 * `{ rows, nextCursor }`, the object trail `{ results }`.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-the-audit-trail-widget-reads-the-app-wide-feed
+		 * @return {Promise<void>}
+		 */
 		async fetchEntries() {
-			if (!this.register || !this.schema || !this.objectId) {
+			const url = this.fetchUrl
+			if (!url) {
 				return
 			}
 			this.loading = true
 			try {
-				const params = new URLSearchParams({ limit: String(this.maxDisplay) })
-				const response = await fetch(
-					prefixUrl(`${this.apiBase}/objects/${this.register}/${this.schema}/${this.objectId}/audit-trail?${params.toString()}`),
-					{ headers: buildHeaders() },
-				)
+				const response = await fetch(prefixUrl(url), { headers: buildHeaders() })
 				if (response.ok) {
 					const data = await response.json()
-					this.entries = data.results || data || []
+					const list = data.results || data.rows || data
+					this.entries = Array.isArray(list) ? list : []
 				} else {
 					this.entries = []
 				}

package/src/components/CnAuditTrailWidget/CnAuditTrailWidget.vue

@@ -5,10 +5,11 @@
 
 <template>
 	<CnAuditTrailCard
-		v-if="resolvedRegister && resolvedSchema && resolvedObjectId"
+		v-if="resolvedScope === 'app' || (resolvedRegister && resolvedSchema && resolvedObjectId)"
 		:register="resolvedRegister"
 		:schema="resolvedSchema"
 		:objectId="resolvedObjectId"
+		:scope="resolvedScope"
 		:title="resolvedTitle"
 		:maxDisplay="resolvedMaxDisplay" />
 </template>
@@ -70,6 +71,15 @@ export default {
 		title: { type: String, default: '' },
 		/** Maximum audit rows to render (0 falls back to the card default). */
 		maxDisplay: { type: Number, default: 0 },
+		/**
+		 * `app` lists the app-wide feed (every object the caller may read,
+		 * narrowed to `register` / `schema` when set) and needs no object;
+		 * `object` (the default) is one object's trail. Also read from
+		 * `content.scope`.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-the-audit-trail-widget-reads-the-app-wide-feed
+		 */
+		scope: { type: String, default: '' },
 		/** Stored widget content blob (CnDashboardPage registry branch): `{ title, maxDisplay, register?, schema?, objectId? }`. */
 		content: { type: Object, default: () => ({}) },
 	},
@@ -115,6 +125,17 @@ export default {
 			return typeof s === 'string' ? s : (s && (s.slug || s.name || s.id)) || ''
 		},
 
+		/**
+		 * The feed scope: explicit prop → content → `object`.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-the-audit-trail-widget-reads-the-app-wide-feed
+		 * @return {('object'|'app')}
+		 */
+		resolvedScope() {
+			const s = this.scope || this.content.scope
+			return s === 'app' ? 'app' : 'object'
+		},
+
 		/**
 		 * The card title: explicit prop → content → '' (card default).
 		 *

package/src/components/CnBreadcrumbs/CnBreadcrumbs.vue

@@ -18,6 +18,7 @@
 	<NcBreadcrumbs
 		v-if="crumbs.length > 0"
 		:aria-label="ariaLabel"
+		:rootIcon="rootText ? '' : undefined"
 		data-testid="cn-breadcrumbs">
 		<!-- `name` falls back to '' because NcBreadcrumb declares it a REQUIRED
 		     String and warns per render on the label-less icon-only crumb. The
@@ -97,6 +98,19 @@ export default {
 			type: String,
 			default: () => t('nextcloud-vue', 'Breadcrumbs'),
 		},
+
+		/**
+		 * Draw the FIRST crumb's label as text. NcBreadcrumbs gives the root
+		 * crumb a home icon and prints its `label` only as the accessible
+		 * name, so "All cases" read as a house. Off by default, which keeps
+		 * the home icon. A first crumb with its own `icon` keeps that icon.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps-2/specs/zuiddrecht-pixel-gaps-2/spec.md#requirement-a-declared-breadcrumb-label-shows-as-text
+		 */
+		rootText: {
+			type: Boolean,
+			default: false,
+		},
 	},
 
 	methods: {

package/src/components/CnCellRenderer/CnCellRenderer.vue

@@ -177,6 +177,9 @@ import { safeHref } from '../../utils/safeHref.js'
 import { formatValue } from '../../utils/schema.js'
 import { CnStatusBadge } from '../CnStatusBadge/index.js'
 
+/** A uuid in any version, the shape OpenRegister ids take. */
+const UUID_PATTERN = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i
+
 /**
  * Module-level set of column keys already warned about for a
  * `widget:"link"` declaration with no resolvable target — guarantees
@@ -483,13 +486,20 @@ export default {
 		 *
 		 * @return {string}
 		 * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-small-opt-ins-from-the-decidiq-and-learniq-lanes
 		 */
 		dateLabel() {
 			const date = parseDateValue(this.value)
 			if (date === null) {
 				return ''
 			}
-			const options = { day: 'numeric', month: 'short', year: 'numeric' }
+			// `widgetProps.showTime: true` adds the time of day ("5 Oct 2026,
+			// 08:30"); `widgetProps.timeOnly: true` shows just the time
+			// ("08:30"), for a timetable row. Default: the date alone.
+			const props = this.widgetProps || {}
+			const options = props.timeOnly === true
+				? { hour: '2-digit', minute: '2-digit' }
+				: { day: 'numeric', month: 'short', year: 'numeric', ...(props.showTime === true ? { hour: '2-digit', minute: '2-digit' } : {}) }
 			let locale
 			try {
 				locale = getCanonicalLocale()
@@ -738,6 +748,27 @@ export default {
 			return undefined
 		},
 
+		/**
+		 * Whether the cell draws a uuid, and so takes the monospace uuid
+		 * style. The property's `format: "uuid"` alone used to decide this,
+		 * so a reference that a formatter or a widget had resolved to its
+		 * name was still drawn as code. Now the value has to be a uuid AND
+		 * nothing resolves it: a resolving widget or formatter, or a value
+		 * that is not a uuid, renders in the normal text style.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-a-resolved-reference-is-not-drawn-as-a-uuid
+		 * @return {boolean}
+		 */
+		showsUuid() {
+			if (this.property?.format !== 'uuid') {
+				return false
+			}
+			if (this.widgetComponent || this.widget || this.hasFormatter) {
+				return false
+			}
+			return typeof this.value === 'string' && UUID_PATTERN.test(this.value)
+		},
+
 		cellClass() {
 			const classes = []
 			if (this.propertyType === 'boolean') {
@@ -749,7 +780,7 @@ export default {
 			if (this.property?.format === 'date-time' || this.property?.format === 'date') {
 				classes.push('cn-cell-renderer--date')
 			}
-			if (this.property?.format === 'uuid') {
+			if (this.showsUuid) {
 				classes.push('cn-cell-renderer--uuid')
 			}
 			if (this.propertyType === 'integer' || this.propertyType === 'number') {