@conduction/nextcloud-vue 2.58.0 → 2.60.0

package/dist/esm/components/CnIndexPage/CnIndexPage.vue2.js

@@ -15,14 +15,16 @@ import { useSavedViewsApi } from '../../composables/useSavedViewsApi.js';
 import { METADATA_COLUMNS } from '../../constants/metadata.js';
 import { routeHref } from '../../utils/actionLink.js';
 import { resolveRegisteredHandler, buildOnSuccessRoute } from '../../utils/actionsDispatcher.js';
+import { fetchFilterCounts } from '../../utils/fetchFilterCounts.js';
 import { buildExportUrl } from '../../utils/indexExportHelpers.js';
 import { openRowTarget } from '../../utils/linkNavigation.js';
-import { resolveClaimedTeams, splitViewsIntoTabs, viewAsTab, resolveClaimTokens } from '../../utils/listLenses.js';
+import { resolveClaimedTeams, splitViewsIntoTabs, viewAsTab, resolveClaimTokens, viewIdOf } from '../../utils/listLenses.js';
 import { LIST_SHORTCUTS, listPaletteCommands, shortcutFor } from '../../utils/listShortcuts.js';
 import { multiKeySort } from '../../utils/multiKeySort.js';
 import { resolveDeepTokens, resolveFilterValue } from '../../utils/resolveFilterTokens.js';
+import { resolveFilterMap } from '../../utils/routeFilters.js';
 import { DEFAULT_ROW_ACTION_FIELD, availableRowActions, refusalReasonFor, undeclaredRowActions } from '../../utils/rowActionAvailability.js';
-import { isNewTabClick, isRowMiddleClick, markNewTabHandled } from '../../utils/rowAuxClick.js';
+import { isNewTabClick, preventMiddleClickAutoscroll, isRowMiddleClick, isNewTabHandled, markNewTabHandled } from '../../utils/rowAuxClick.js';
 import { DEFAULT_ROW_INDICATOR_CAP } from '../../utils/rowIndicators.js';
 import { viewMatchesScope, extractViewState, buildRouteQueryFromViewState, extractViewStateFromRouteQuery, buildViewCreatePayload, savedViewScope } from '../../utils/savedViewHelpers.js';
 import { columnsFromSchema } from '../../utils/schema.js';
@@ -240,7 +242,8 @@ function namedFilterToQuery(values) {
  * @event {object} mass-export — Mass export confirmed. Payload: { ids, format }
  * @event {object} mass-import — Mass import confirmed. Payload: import data
  * @event {void} refresh — Refresh button clicked
- * @event {object} row-click — Table row or card clicked or middle-clicked. Payload: (row, event) — the row object and the native click/auxclick event
+ * @event {object} row-click — Table row or card clicked. Payload: (row, event) — the row object and the native click event
+ * @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
@@ -436,7 +439,6 @@ var script = {
 			default: null,
 		},
 
-		/* eslint-disable vue/no-unused-properties -- used in useSelfFetchList */
 		/**
 		 * Base filter for the self-fetch path. String values of the form
 		 * `"@route.<name>"` / `":<name>"` are interpolated from `$route.params`.
@@ -445,7 +447,6 @@ var script = {
 			type: Object,
 			default: null,
 		},
-		/* eslint-enable vue/no-unused-properties */
 
 		/**
 		 * Self-fetch mode only — an array of clickable filter tabs rendered as
@@ -1448,6 +1449,19 @@ var script = {
 			default: () => [],
 		},
 
+		/**
+		 * Which saved views show how many records they match: `true` for all
+		 * of them (tabs and the entries in the views control), or a list of
+		 * view ids. Off by default, so no count request is made. A quick
+		 * filter opts in on its own entry with `showCount: true`.
+		 *
+		 * @type {boolean|string[]}
+		 */
+		viewCounts: {
+			type: [Boolean, Array],
+			default: false,
+		},
+
 		/**
 		 * The teams this person may claim. The instance decides this list; it
 		 * is the membership side of `claimedTeams`.
@@ -1813,6 +1827,7 @@ var script = {
 		'quick-filter-change',
 		'refresh',
 		'row-click',
+		'row-aux-click',
 		'search',
 		'select',
 		'sort',
@@ -1885,6 +1900,10 @@ var script = {
 	data() {
 		return {
 			currentViewMode: this.viewMode,
+			/** Count per tab-strip index, for the entries that asked for one; null = none. */
+			tabCounts: null,
+			/** Count per saved-view id, for the views control; null = none. */
+			savedViewCounts: null,
 			/**
 			 * The non-`_` query keys this page owns, i.e. may clear on the next
 			 * persist. Seeded with what it adopted from the query on load, and
@@ -2055,6 +2074,9 @@ var script = {
 		 * that is what Add does (no host `@add` listener) and the router can
 		 * resolve it. The bar then renders Add as a real link; null otherwise.
 		 *
+		 * `$.vnode.props` is not reactive, so an `add` listener attached or
+		 * removed after mount does not re-evaluate this.
+		 *
 		 * @return {string|object|null}
 		 */
 		addLinkTo() {
@@ -2474,6 +2496,55 @@ var script = {
 			return this.splitSavedViews.control
 		},
 
+		/**
+		 * The filters whose record count this page shows: quick filters that
+		 * set `showCount`, and the saved views `viewCounts` names. Empty when
+		 * nothing opted in, which is what keeps the page from making a count
+		 * request nobody asked for.
+		 *
+		 * @return {Array<{key: string, filter: object}>} The filters to count.
+		 * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+		 */
+		countEntries() {
+			const entries = [];
+			const tabs = this.tabStripEntries || [];
+			const lens = this.lensTabs.length > 0;
+			tabs.forEach((tab, index) => {
+				const wants = lens ? this.viewWantsCount(tab.id) : (tab && tab.showCount === true);
+				if (wants && tab.narrowsToNothing !== true) {
+					entries.push({ key: `tab:${index}`, filter: tab.filter || {} });
+				}
+			});
+			for (const view of this.viewsForControl) {
+				const id = viewIdOf(view);
+				if (this.viewWantsCount(id)) {
+					entries.push({ key: `view:${id}`, filter: viewAsTab(view).filter });
+				}
+			}
+			return entries
+		},
+
+		/**
+		 * Changes whenever the counts have to be fetched again: another set
+		 * of filters, another register or schema, or a list whose total moved
+		 * (a record was added, removed, or left a filter).
+		 *
+		 * @return {string} The signature.
+		 * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+		 */
+		countRequestKey() {
+			if (this.countEntries.length === 0) {
+				return ''
+			}
+			return JSON.stringify({
+				r: this.register,
+				s: this.exportSchemaSlug,
+				f: this.filter || null,
+				e: this.countEntries,
+				t: Number(this.effectivePagination?.total ?? 0),
+			})
+		},
+
 		/**
 		 * What the tab strip shows: the page's lens tabs when it named any,
 		 * else its quick filters. One strip, never two, so a person is not
@@ -3512,6 +3583,14 @@ var script = {
 	},
 
 	watch: {
+		countRequestKey: {
+			immediate: true,
+			/** @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views */
+			handler() {
+				this.loadFilterCounts();
+			},
+		},
+
 		// Remember the whole folder set whenever no folder narrows the query.
 		folderSidebarLiveFacetValues: {
 			immediate: true,
@@ -3721,6 +3800,61 @@ var script = {
 	},
 
 	methods: {
+		/**
+		 * Whether a saved view shows its record count (`viewCounts`).
+		 *
+		 * @param {string} id The view id.
+		 * @return {boolean} True when the view opted in.
+		 * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+		 */
+		viewWantsCount(id) {
+			if (this.viewCounts === true) {
+				return true
+			}
+			return Array.isArray(this.viewCounts) && this.viewCounts.map(String).includes(String(id))
+		},
+
+		/**
+		 * Fetch the record counts for the filters and views that asked for
+		 * one. Filters that narrow the same single field share one grouped
+		 * request. A failed count leaves that entry without a number.
+		 *
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+		 */
+		async loadFilterCounts() {
+			const requestKey = this.countRequestKey;
+			const schema = this.exportSchemaSlug;
+			if (requestKey === '' || !this.register || !schema) {
+				this.tabCounts = null;
+				this.savedViewCounts = null;
+				return
+			}
+			const params = (this.$route && this.$route.params) || {};
+			const ctx = typeof this.selfFetchTokenCtx === 'function' ? this.selfFetchTokenCtx() : {};
+			const counts = await fetchFilterCounts({
+				register: this.register,
+				schema,
+				entries: this.countEntries.map((entry) => ({ key: entry.key, filter: resolveFilterMap(entry.filter, params, ctx) })),
+				baseFilter: resolveFilterMap(this.filter, params, ctx),
+				ctx,
+			});
+			if (requestKey !== this.countRequestKey) {
+				return
+			}
+			const tabCounts = {};
+			const viewCounts = {};
+			for (const [key, value] of Object.entries(counts)) {
+				if (key.startsWith('tab:')) {
+					tabCounts[Number(key.slice(4))] = value;
+				} else {
+					viewCounts[key.slice(5)] = value;
+				}
+			}
+			this.tabCounts = tabCounts;
+			this.savedViewCounts = viewCounts;
+		},
+
 		// ── Split view (case-page-and-list-as-a-place) ──────────────────
 
 		/**
@@ -4810,21 +4944,60 @@ var script = {
 		/**
 		 * Row/card click: toggles selection when `selectable` (covers the custom
 		 * `cardComponent` path), otherwise emits `row-click` for navigation. A
-		 * ctrl/cmd/shift or middle click opens a named source's row in a new tab.
+		 * ctrl/cmd/shift click opens a named source's row in a new tab.
 		 *
 		 * The `@event` block below sits directly against its `$emit`, and must
 		 * stay there. vue-docgen binds an event's description to the emit it
 		 * IMMEDIATELY precedes.
 		 *
 		 * @param {object} row The clicked row object
-		 * @param {MouseEvent|KeyboardEvent} [event] The originating click/auxclick event.
+		 * @param {MouseEvent|KeyboardEvent} [event] The originating click event.
 		 */
 		onRowClick(row, event) {
+			if (!this.routeClickedRow(row, event)) {
+				return
+			}
+			/**
+			 * @event row-click Emitted on a row/card click for navigation. Fires when `selectable` is false, OR when `rowClickToView` is set and something can open the row (selection then happens via the checkbox). Payload: `(row, event)` — the clicked row and the native click event (absent for a keyboard shortcut or map marker), so a host can open the row in a new tab on a ctrl/cmd/shift click with `openRowTarget`. A middle click emits `row-aux-click` instead.
+			 * @type {object} The clicked row object.
+			 */
+			this.$emit('row-click', ...(event ? [row, event] : [row]));
+		},
+
+		/**
+		 * Row/card middle click: opens a named source's row in a new tab and
+		 * emits `row-aux-click`, not `row-click`, so a host whose `row-click`
+		 * listener navigates never moves the current tab away.
+		 *
+		 * @param {object} row The clicked row object
+		 * @param {MouseEvent} event The originating auxclick event.
+		 */
+		onRowAuxClick(row, event) {
+			if (!this.routeClickedRow(row, event)) {
+				return
+			}
+			/**
+			 * @event row-aux-click Emitted on a row/card middle click, under the same conditions as `row-click`, so a host can open the row in a new tab with `openRowTarget`. Payload: `(row, event)` — the clicked row and the native auxclick event.
+			 * @type {object} The clicked row object.
+			 */
+			this.$emit('row-aux-click', row, event);
+		},
+
+		/**
+		 * The shared part of a row click and a middle click: on a selectable
+		 * page a plain click toggles selection instead, and a named source opens
+		 * its own row.
+		 *
+		 * @param {object} row The clicked row object
+		 * @param {MouseEvent|KeyboardEvent} [event] The originating event.
+		 * @return {boolean} Whether the click navigates, so the caller emits.
+		 */
+		routeClickedRow(row, event) {
 			if (this.selectable && !this.rowClickOpens) {
 				if (!event || event.button === undefined || event.button === 0) {
 					this.onSelect(this.toggleIdInArray(this.internalSelectedIds, row[this.rowKey]));
 				}
-				return
+				return false
 			}
 			// A named source knows where its rows live. Emitting only would leave
 			// the click inert on a manifest page, which has no listener to bind —
@@ -4871,11 +5044,7 @@ var script = {
 					}
 				}
 			}
-			/**
-			 * @event row-click Emitted on a row/card click (or middle click) for navigation. Fires when `selectable` is false, OR when `rowClickToView` is set and something can open the row (selection then happens via the checkbox). Payload: `(row, event)` — the clicked row and the native click/auxclick event (absent for a keyboard shortcut or map marker), so a host can open the row in a new tab on a ctrl/cmd/shift or middle click with `openRowTarget`.
-			 * @type {object} The clicked row object.
-			 */
-			this.$emit('row-click', ...(event ? [row, event] : [row]));
+			return true
 		},
 
 		/**
@@ -4889,17 +5058,31 @@ var script = {
 			return typeof Event !== 'undefined' && value instanceof Event
 		},
 
+		/**
+		 * Mousedown on a custom list/card component's root: when a middle click
+		 * opens the row, keep the browser from starting autoscroll.
+		 *
+		 * @param {MouseEvent} event The mousedown event.
+		 * @return {void}
+		 */
+		onCustomItemMouseDown(event) {
+			if (!this.selectable || this.rowClickOpens) {
+				preventMiddleClickAutoscroll(event);
+			}
+		},
+
 		/**
 		 * Middle click on a custom list/card component's root: open the row
-		 * like a click would.
+		 * like a middle click on a built-in card would. Skipped when something
+		 * inside the component already opened it in a new tab.
 		 *
 		 * @param {object} row The component's row.
 		 * @param {MouseEvent} event The auxclick event.
 		 * @return {void}
 		 */
 		onCustomItemAuxClick(row, event) {
-			if (isRowMiddleClick(event)) {
-				this.onRowClick(row, event);
+			if (isRowMiddleClick(event) && !isNewTabHandled(event)) {
+				this.onRowAuxClick(row, event);
 			}
 		},