@conduction/nextcloud-vue 2.75.0 → 2.77.0

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

@@ -15,7 +15,7 @@ import __sfc_main$v from '../../dialogs/CnConfirmDialog.vue.js';
 import __sfc_main$w from '../../dialogs/CnQuickEditDialog.vue.js';
 import __sfc_main from '../CnBuildiqEditButton/CnBuildiqEditButton.vue.js';
 import __sfc_main$2 from '../CnEmptyContent/CnEmptyContent.vue.js';
-import __sfc_main$1 from '../CnFavouriteToggle/CnFavouriteToggle.vue.js';
+import __sfc_main$1 from '../CnFollowToggle/CnFollowToggle.vue.js';
 import { useLook } from '../../composables/useLook.js';
 import { copyKindsOf } from '../../composables/useObjectCopy.js';
 import { createRefLabelResolver } from '../../composables/useRefLabels.js';
@@ -27,10 +27,12 @@ import { resolveRegisteredHandler, buildOnSuccessRoute } from '../../utils/actio
 import { reportBindingProblems } from '../../utils/diagnostics.js';
 import { fetchFilterCounts } from '../../utils/fetchFilterCounts.js';
 import { buildExportUrl } from '../../utils/indexExportHelpers.js';
+import { lensUnavailableText } from '../../utils/lensAvailability.js';
 import { openRowTarget } from '../../utils/linkNavigation.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 { OBJECTS_CHANGED_EVENT } from '../../utils/objectSignals.js';
 import { withPersonalLenses } from '../../utils/personalLenses.js';
 import { resolveDeepTokens, resolveFilterValue } from '../../utils/resolveFilterTokens.js';
 import { resolveRowActions } from '../../utils/resolveRowActions.js';
@@ -79,7 +81,7 @@ import { buildDefaultActions } from './defaultActions.js';
 import { dispatchAction } from './manifestActionDispatch.js';
 import { applyManualOrder, manualOrderKey, moveInOrder, visibleIdsOf, dropInOrder } from './manualOrder.js';
 import { reconcilePersonalColumns, orderColumns, personalColumnsKey } from './personalColumns.js';
-import { createSelfModeActions } from './selfModeActions.js';
+import { createSelfModeActions, resolveRowTarget } from './selfModeActions.js';
 import { applyRowPatches, splitLayoutFor, normalisePaneWidth, rowIdOf } from './splitView.js';
 import { useNamedSource } from './useNamedSource.js';
 import { useSelfFetchList } from './useSelfFetchList.js';
@@ -99,8 +101,8 @@ const CALENDAR_PAGE_SIZE = 200;
  */
 const RANGE_SEPARATOR = '..';
 
-/** Key of the synthetic star column (`showFavouriteColumn`). */
-const FAVOURITE_COLUMN_KEY = '__favourite';
+/** Key of the synthetic follow column (`showFollowColumn`). */
+const FOLLOW_COLUMN_KEY = '__follow';
 
 /**
  * Whether a schema property wants a from/to pair rather than a value list.
@@ -302,7 +304,7 @@ var script = {
 
 	components: {
 		CnBuildiqEditButton: __sfc_main,
-		CnFavouriteToggle: __sfc_main$1,
+		CnFollowToggle: __sfc_main$1,
 		NcLoadingIcon,
 		CnEmptyContent: __sfc_main$2,
 		NcActions,
@@ -539,6 +541,17 @@ var script = {
 			default: null,
 		},
 
+		/**
+		 * Gives each card in the card view a status accent: a colored start
+		 * border and icon. See CnObjectCard `accent`.
+		 *
+		 * @type {((object: object) => ({variant: string, icon: string, label: string}|null))|null}
+		 */
+		cardAccent: {
+			type: Function,
+			default: null,
+		},
+
 		/**
 		 * Board look: free text after the footer's count ("8 of 48 · click a
 		 * column header to sort"). Manifest key `config.footerNote`.
@@ -627,9 +640,10 @@ var script = {
 		},
 
 		/**
-		 * Personal lenses appended to the quick filters: any of `favourite`
-		 * (`_favourite`), `recent` (`_recent`), `watching` (`_watching`) and
-		 * `unread` (`_unread`).
+		 * Personal lenses appended to the quick filters: any of `watching`
+		 * (`_watching`, labelled Following), `recent` (`_recent`) and `unread`
+		 * (`_unread`). `favourite` is a deprecated alias of `watching`: a
+		 * favourite is a follow now, and asking for both gives one tab.
 		 * They combine with every other filter. While Recent is active column
 		 * sorting is off, because the lens owns the order. Manifest
 		 * `config.personalLenses`.
@@ -642,9 +656,20 @@ var script = {
 		},
 
 		/**
-		 * Add a first column with a star per row (`CnFavouriteToggle`), bound to
-		 * each row's `@self.favourite`. Clicking it does not open the row.
-		 * Manifest `config.showFavouriteColumn`.
+		 * Add a first column with a follow toggle per row (`CnFollowToggle`,
+		 * compact), bound to each row's `@self.watching`. Clicking it does not
+		 * open the row. Manifest `config.showFollowColumn`.
+		 */
+		showFollowColumn: {
+			type: Boolean,
+			default: false,
+		},
+
+		/**
+		 * Deprecated alias of `showFollowColumn`: the star column became the
+		 * follow column (OpenRegister `merge-follow-and-favourites`).
+		 *
+		 * @deprecated Use `showFollowColumn`.
 		 */
 		showFavouriteColumn: {
 			type: Boolean,
@@ -710,6 +735,21 @@ var script = {
 			default: () => [],
 		},
 
+		/**
+		 * Self-fetch only: list from this endpoint instead of
+		 * `/api/objects/{register}/{schema}`, e.g. an app endpoint that searches
+		 * several register/schema pairs at once. `register` and `schema` stay the
+		 * page's own pair (columns, create, export, import). Rows of another pair,
+		 * read from their `@self.register` / `@self.schema`, are edited, copied and
+		 * deleted against that pair, with its own form. The endpoint takes
+		 * `_page`, `_limit`, `_search` and `_order[key]=dir` and answers
+		 * `{ results, total, page, pages }`.
+		 */
+		collectionUrl: {
+			type: String,
+			default: '',
+		},
+
 		/**
 		 * Offer an "Also search inside files" switch beside the search box. On,
 		 * a search also matches words inside attached files (OpenRegister
@@ -1124,6 +1164,34 @@ var script = {
 			default: 'No items found',
 		},
 
+		/**
+		 * Personal-lens report of the list on screen, for a host that fetches
+		 * itself: the response's `@self.lenses` (`{ recent: { available,
+		 * reason } }`). In self-fetch mode the page reads it from the store
+		 * and this prop is ignored. When a lens reports `available: false`
+		 * the empty state explains why instead of showing `emptyText`.
+		 *
+		 * @type {object|null}
+		 * @spec openspec/changes/lens-says-why-it-is-empty/specs/personal-lens-availability/spec.md#requirement-an-unavailable-lens-explains-its-empty-page
+		 */
+		lenses: {
+			type: Object,
+			default: null,
+		},
+
+		/**
+		 * App wording for an unavailable lens, keyed `<lens>.<reason>`
+		 * (`recent.audit-trail-disabled`) or `<reason>`; the specific key
+		 * wins, and both win over the library's object-neutral text.
+		 *
+		 * @type {{[key: string]: string}|null}
+		 * @spec openspec/changes/lens-says-why-it-is-empty/specs/personal-lens-availability/spec.md#requirement-an-unavailable-lens-explains-its-empty-page
+		 */
+		lensReasonTexts: {
+			type: Object,
+			default: null,
+		},
+
 		/** Accessible label for the loading spinner (NcLoadingIcon aria-label) */
 		loadingText: {
 			type: String,
@@ -2217,6 +2285,8 @@ var script = {
 			 */
 			persistedFilterKeys: [...(this.initialQueryFilterKeys || [])],
 			internalSelectedIds: [...this.selectedIds],
+			// Rows seen in a collectionUrl list, so a selection kept across pages still resolves its own pair.
+			collectionRowsById: markRaw(new Map()),
 			// Folder-sidebar state: selected folder id + the register-fetched list.
 			selectedFolderId: null,
 			/**
@@ -2254,6 +2324,9 @@ var script = {
 			// Dialog targets
 			actionTargetItem: null,
 			editItem: null,
+			// The pair and schema of a row edited outside the page's own pair (collectionUrl).
+			rowFormTarget: null,
+			rowFormSchema: null,
 			// Drives the Actions-menu Refresh spinner during a self-fetch
 			// refresh, where the host has no promise to bind `:refreshing` to.
 			internalRefreshing: false,
@@ -2310,6 +2383,40 @@ var script = {
 			return this.emptyText ? fn(this.emptyText) : this.emptyText
 		},
 
+		/**
+		 * The personal-lens reports of the list on screen: the store's copy
+		 * of the latest response in self-fetch mode, else the `lenses` prop.
+		 *
+		 * @return {object}
+		 * @spec openspec/changes/lens-says-why-it-is-empty/specs/personal-lens-availability/spec.md#requirement-a-list-response-carries-the-report-of-the-lenses-it-was-asked-for
+		 */
+		effectiveLenses() {
+			if (this.isNamedSource) {
+				return {}
+			}
+			if (this.isSelfFetchMode) {
+				return (this.list.lenses && this.list.lenses.value) || {}
+			}
+			return this.lenses || {}
+		},
+
+		/**
+		 * Why the list is empty when a personal lens could not answer (the
+		 * audit trail is off, nobody is logged in, the history could not be
+		 * read), or `''` to keep the generic empty text.
+		 *
+		 * @return {string}
+		 * @spec openspec/changes/lens-says-why-it-is-empty/specs/personal-lens-availability/spec.md#requirement-an-unavailable-lens-explains-its-empty-page
+		 */
+		lensReasonText() {
+			const text = lensUnavailableText(this.effectiveLenses, this.lensReasonTexts);
+			if (!text) {
+				return ''
+			}
+			const fn = typeof this.cnTranslate === 'function' ? this.cnTranslate : (k) => k;
+			return fn(text)
+		},
+
 		/**
 		 * Whether the host manifest editor is in edit mode (unwraps the injected
 		 * `cnEditingBody`, which may be a Vue ref or a plain boolean). Drives the
@@ -3203,12 +3310,22 @@ var script = {
 			if (this.recentLensActive) {
 				cols = cols.map((col) => (col && typeof col === 'object' ? { ...col, sortable: false } : col));
 			}
-			if (this.showFavouriteColumn && this.favouriteSchemaSlug !== '') {
-				cols = [{ key: FAVOURITE_COLUMN_KEY, label: '', sortable: false, width: '48px' }, ...cols];
+			if (this.followColumnOn && this.favouriteSchemaSlug !== '') {
+				cols = [{ key: FOLLOW_COLUMN_KEY, label: '', sortable: false, width: '48px' }, ...cols];
 			}
 			return cols
 		},
 
+		/**
+		 * Whether the follow column renders (`showFollowColumn`, or the deprecated `showFavouriteColumn`).
+		 *
+		 * @return {boolean}
+		 * @spec openspec/changes/one-follow-control/specs/record-follow/spec.md#requirement-index-pages-offer-one-following-lens-and-a-follow-column
+		 */
+		followColumnOn() {
+			return this.showFollowColumn || this.showFavouriteColumn
+		},
+
 		/**
 		 * Whether the active quick filter is the Recent lens.
 		 *
@@ -3223,7 +3340,7 @@ var script = {
 		},
 
 		/**
-		 * Schema slug the star column calls with: the page's own slug in self-fetch
+		 * Schema slug the follow column calls with: the page's own slug in self-fetch
 		 * mode, else the schema object's `slug`. Empty when neither is known.
 		 *
 		 * @return {string}
@@ -3535,6 +3652,16 @@ var script = {
 			return (this.schema && typeof this.schema === 'object') ? this.schema : null
 		},
 
+		/** The form dialog's schema: the edited row's own when it is of another pair. */
+		formSchema() {
+			return this.rowFormTarget ? this.rowFormSchema : this.effectiveSchema
+		},
+
+		/** The form dialog's register, following `formSchema`. */
+		formRegister() {
+			return this.rowFormTarget ? this.rowFormTarget.register : this.register
+		},
+
 		/**
 		 * Schema slug for the export-leaf URL — the `schema` prop directly
 		 * when it's a string (self-fetch mode's precondition), else the
@@ -3921,8 +4048,7 @@ var script = {
 							this.$emit('edit-open', row);
 							return
 						}
-						this.editItem = row;
-						this.showFormDialogVisible = true;
+						this.openFormFor(row);
 					},
 					onCopy: (row) => {
 						this.actionTargetItem = row;
@@ -4431,6 +4557,21 @@ var script = {
 	},
 
 	watch: {
+		effectiveObjects: {
+			immediate: true,
+			handler(rows) {
+				if (!this.collectionUrl || !this.isSelfFetchMode || !Array.isArray(rows)) {
+					return
+				}
+				for (const row of rows) {
+					const id = row?.id ?? row?.['@self']?.id;
+					if (id !== undefined && id !== null) {
+						this.collectionRowsById.set(id, row);
+					}
+				}
+			},
+		},
+
 		// A column or form field bound to a property the schema lacks is told to the host once.
 		effectiveSchema: {
 			immediate: true,
@@ -4623,6 +4764,9 @@ var script = {
 		if (this.splitViewEnabled && typeof window !== 'undefined') {
 			window.addEventListener('resize', this.measureSplitViewport);
 		}
+		if (typeof window !== 'undefined') {
+			window.addEventListener(OBJECTS_CHANGED_EVENT, this.onObjectsChanged);
+		}
 		this.loadManualOrder();
 		this.loadPersonalColumns();
 		this.publishHoistedSidebar();
@@ -4647,6 +4791,8 @@ var script = {
 		this.selfActions = createSelfModeActions({
 			isSelfFetchMode: () => this.isSelfFetchMode,
 			selfObjectStore: () => this.selfObjectStore,
+			rowTarget: (row) => this.rowTypeTarget(row),
+			knownRow: (id) => this.collectionRowsById.get(id),
 			selfObjectType: () => this.selfObjectType,
 			list: () => this.list,
 			selectedIds: () => this.internalSelectedIds,
@@ -4672,13 +4818,14 @@ var script = {
 	},
 
 	/**
-	 * Drop the resize listener and the hoisted sidebar.
+	 * Drop the window listeners and the hoisted sidebar.
 	 *
 	 * @spec openspec/changes/case-page-and-list-as-a-place/specs/index-page/spec.md
 	 */
 	beforeUnmount() {
 		if (typeof window !== 'undefined') {
 			window.removeEventListener('resize', this.measureSplitViewport);
+			window.removeEventListener(OBJECTS_CHANGED_EVENT, this.onObjectsChanged);
 		}
 		// Clear the holder so the hoisted sidebar disappears when
 		// the user navigates away from the index page.
@@ -6140,6 +6287,33 @@ var script = {
 			}
 		},
 
+		/**
+		 * Refresh the list when `dispatchObjectsChanged` names this page's
+		 * register and schema, by slug or id. A part missing on either side matches.
+		 *
+		 * @param {CustomEvent} event The objects-changed event.
+		 * @return {void}
+		 */
+		onObjectsChanged(event) {
+			// A collection list can hold rows of any pair, so any change may show in it.
+			if (this.isSelfFetchMode && this.collectionUrl) {
+				this.onRefreshEvent();
+				return
+			}
+			const detail = (event && event.detail) || {};
+			const schema = this.effectiveSchema;
+			const schemaIds = [this.schema, schema && schema.id, schema && schema.slug]
+				.filter((v) => v !== undefined && v !== null && v !== '' && typeof v !== 'object')
+				.map(String);
+			if (detail.register && this.register && detail.register !== String(this.register)) {
+				return
+			}
+			if (detail.schema && schemaIds.length > 0 && !schemaIds.includes(detail.schema)) {
+				return
+			}
+			this.onRefreshEvent();
+		},
+
 		/** @return {Promise<void>} */
 		async onRefreshEvent() {
 			this.$emit('refresh');
@@ -7282,6 +7456,8 @@ var script = {
 		closeFormDialog() {
 			this.showFormDialogVisible = false;
 			this.editItem = null;
+			this.rowFormTarget = null;
+			this.rowFormSchema = null;
 		},
 
 		/**
@@ -7342,8 +7518,55 @@ var script = {
 		 * @public
 		 */
 		openFormDialog(item = null) {
-			this.editItem = item;
-			this.showFormDialogVisible = true;
+			return this.openFormFor(item)
+		},
+
+		/**
+		 * Open the form dialog for an item. A row of another pair (collectionUrl)
+		 * opens with its own schema; everything else opens at once, as before.
+		 *
+		 * @param {object|null} item The row to edit, or null to create.
+		 * @return {Promise<void>|void}
+		 */
+		openFormFor(item) {
+			const target = item ? this.rowTypeTarget(item) : null;
+			if (!target) {
+				this.rowFormTarget = null;
+				this.rowFormSchema = null;
+				this.editItem = item;
+				this.showFormDialogVisible = true;
+				return
+			}
+			const store = this.selfObjectStore;
+			return Promise.resolve(store.getSchema?.(target.type) || store.fetchSchema?.(target.type))
+				.catch(() => null)
+				.then((schema) => {
+					if (!schema) {
+						this.toastSavedView('error', translate('nextcloud-vue', 'Could not load the form for this item.'));
+						return
+					}
+					this.rowFormTarget = target;
+					this.rowFormSchema = schema;
+					this.editItem = item;
+					this.showFormDialogVisible = true;
+				})
+		},
+
+		/**
+		 * The row's own pair when it differs from the page's in a collectionUrl list.
+		 *
+		 * @param {object} row The row.
+		 * @return {{register: string, schema: string, type: string}|null} The pair, or null.
+		 */
+		rowTypeTarget(row) {
+			return resolveRowTarget({
+				collectionUrl: this.isSelfFetchMode ? this.collectionUrl : '',
+				register: this.register,
+				schema: this.schema,
+				primarySchema: this.effectiveSchema,
+				primaryRegister: this.selfObjectStore?.getRegister?.(this.selfObjectType) || null,
+				store: this.selfObjectStore,
+			}, row)
 		},
 
 		/**