@conduction/nextcloud-vue 2.68.0 → 2.70.0

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

@@ -5,6 +5,7 @@ import { NcActionButton, NcActionCaption, NcActionLink, NcActionSeparator, NcBut
 import { ref, provide, watch } from 'vue';
 import AlertCircleOutline from 'vue-material-design-icons/AlertCircleOutline.vue';
 import ArrowLeft from 'vue-material-design-icons/ArrowLeft.vue';
+import Check from 'vue-material-design-icons/Check.vue';
 import ChevronLeft from 'vue-material-design-icons/ChevronLeft.vue';
 import ChevronRight from 'vue-material-design-icons/ChevronRight.vue';
 import Cog from 'vue-material-design-icons/Cog.vue';
@@ -13,6 +14,7 @@ import InformationOutline from 'vue-material-design-icons/InformationOutline.vue
 import Pencil from 'vue-material-design-icons/Pencil.vue';
 import Plus from 'vue-material-design-icons/Plus.vue';
 import Refresh from 'vue-material-design-icons/Refresh.vue';
+import Restore from 'vue-material-design-icons/Restore.vue';
 import ViewDashboardOutline from 'vue-material-design-icons/ViewDashboardOutline.vue';
 import __sfc_main$i from '../../dialogs/CnRelationLinkModal.vue.js';
 import __sfc_main$h from '../../dialogs/CnWidgetStyleEditorModal.vue.js';
@@ -201,9 +203,11 @@ var script = {
 		CnTranslatedBadge: __sfc_main$g,
 		CnWidgetStyleEditorModal: __sfc_main$h,
 		CnRelationLinkModal: __sfc_main$i,
+		Check,
 		Cog,
 		Plus,
 		Pencil,
+		Restore,
 	},
 
 	mixins: [gridLayout, pageViews],
@@ -696,6 +700,20 @@ var script = {
 			default: '',
 		},
 
+		/**
+		 * Whether the user arranges each view (`views`) for themselves. On,
+		 * the header offers Arrange view next to the view switch; the
+		 * arrangement is stored per view and per user (the server, mirrored
+		 * in the browser) and a reset returns the view to its manifest
+		 * layout. Off (the default), a view renders as the manifest says.
+		 *
+		 * @type {boolean}
+		 */
+		userLayout: {
+			type: Boolean,
+			default: false,
+		},
+
 		/**
 		 * Whether the Refresh entry renders in the page-header menu.
 		 * Tri-state:
@@ -1119,18 +1137,38 @@ var script = {
 		 * belongs to; the record's display name follows as the current
 		 * crumb. `label` goes through the host translate function and shows
 		 * as text; `icon` (an MDI name, e.g. `Home`) draws that icon instead,
-		 * with the label as its accessible name. Null (the default) draws no
+		 * with the label as its accessible name. `currentField` names a field
+		 * of the record (a dotted path, e.g. `identifier`) whose value is the
+		 * current crumb instead of the display name; an empty value falls back
+		 * to the display name. `separator` draws that text (e.g. `/`) between
+		 * the crumbs instead of the chevron. Null (the default) draws no
 		 * trail.
 		 *
 		 * @spec openspec/changes/zuiddrecht-pixel-gaps/specs/zuiddrecht-pixel-gaps/spec.md#requirement-a-detail-page-drops-its-eyebrow-and-shows-a-breadcrumb
 		 * @spec openspec/changes/zuiddrecht-pixel-gaps-2/specs/zuiddrecht-pixel-gaps-2/spec.md#requirement-a-declared-breadcrumb-label-shows-as-text
-		 * @type {{label: string, route?: string, params?: object, href?: string, icon?: string}|null}
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-a-breadcrumb-can-name-the-record-by-a-field-and-use-a-text-separator
+		 * @type {{label: string, route?: string, params?: object, href?: string, icon?: string, currentField?: string, separator?: string}|null}
 		 */
 		breadcrumb: {
 			type: Object,
 			default: null,
 		},
 
+		/**
+		 * Whether the record's widget cards (the body grid and the side
+		 * column) keep their overflow Actions menu when their definition does
+		 * not say (`showActions`). `false` (manifest
+		 * `config.showWidgetActions: false`) drops it, as on a dashboard; a
+		 * widget with `showActions: true` keeps its menu. A card that offers
+		 * an Add action keeps the menu that holds it. True by default.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-a-detail-page-can-drop-the-widget-actions-menu
+		 */
+		showWidgetActions: {
+			type: Boolean,
+			default: true,
+		},
+
 		/**
 		 * A column of cards beside the body (manifest `config.sideColumn`),
 		 * for the record's facts: deadline, requester, handler, links. Each
@@ -1346,6 +1384,8 @@ var script = {
 
 	data() {
 		return {
+			/** Whether the user is arranging the chosen view (`userLayout`). */
+			arrangingView: false,
 			/** Whether the record edit form is open. */
 			editFormOpen: false,
 			/**
@@ -2320,7 +2360,38 @@ var script = {
 			} else if (crumb.href) {
 				first.href = crumb.href;
 			}
-			return [first, { label: this.displayTitle }]
+			return [first, { label: this.breadcrumbCurrentLabel }]
+		},
+
+		/**
+		 * The current crumb: the record's `breadcrumb.currentField` value
+		 * (the case number on a case page) when declared and filled, else the
+		 * display name.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-a-breadcrumb-can-name-the-record-by-a-field-and-use-a-text-separator
+		 * @return {string}
+		 */
+		breadcrumbCurrentLabel() {
+			const field = this.breadcrumb && this.breadcrumb.currentField;
+			if (typeof field === 'string' && field !== '') {
+				const value = stageOf(this.resolvedObject, field);
+				if (value !== '') {
+					return value
+				}
+			}
+			return this.displayTitle
+		},
+
+		/**
+		 * The text drawn between the crumbs (`breadcrumb.separator`), or ''
+		 * for the chevron.
+		 *
+		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-a-breadcrumb-can-name-the-record-by-a-field-and-use-a-text-separator
+		 * @return {string}
+		 */
+		breadcrumbSeparator() {
+			const separator = this.breadcrumb && this.breadcrumb.separator;
+			return typeof separator === 'string' ? separator : ''
 		},
 
 		/**
@@ -2516,7 +2587,7 @@ var script = {
 		viewDisplayLayout() {
 			// eslint-disable-next-line @typescript-eslint/no-unused-expressions -- reading the flag IS the effect, as in bodyGridLayout
 			this.editingBody;
-			return this.activeView ? this.closeDroppedRows(this.activeView.layout) : []
+			return this.activeView ? this.closeDroppedRows(this.activeViewLayout) : []
 		},
 
 		/**
@@ -2534,16 +2605,18 @@ var script = {
 		 * chosen view's grid in the region the view switch controls (left out
 		 * when the view is empty; the empty state takes the region then).
 		 *
-		 * @return {Array<{key: string, view: boolean, layout: Array<object>, attrs: object}>}
+		 * @return {Array<{key: string, view: boolean, layout: Array<object>, editable: boolean, attrs: object}>}
 		 * @spec openspec/changes/view-switch-containers/specs/view-switch-containers/spec.md#requirement-a-page-declares-views-that-each-hold-a-widget-grid
 		 */
 		bodyGridSections() {
-			const sections = this.hasBodyGrid ? [{ key: 'body', view: false, layout: this.bodyGridLayout, attrs: {} }] : [];
+			const sections = this.hasBodyGrid ? [{ key: 'body', view: false, layout: this.bodyGridLayout, editable: this.editingBody, attrs: {} }] : [];
 			if (this.hasViews && !this.viewIsEmpty) {
 				sections.push({
 					key: `view-${this.activeViewId}`,
 					view: true,
 					layout: this.viewDisplayLayout,
+					// The user arranges the view while Arrange view is on.
+					editable: this.editingBody || this.arrangingView,
 					attrs: {
 						id: this.viewRegionId,
 						role: 'region',
@@ -2868,6 +2941,21 @@ var script = {
 	},
 
 	methods: {
+		/**
+		 * Start or finish arranging the chosen view. Finishing stores the
+		 * arrangement of every view the user moved, once.
+		 *
+		 * @return {void}
+		 * @spec openspec/changes/page-view-user-layouts/specs/view-switch-containers/spec.md#requirement-a-user-arranges-each-view-for-themselves
+		 */
+		toggleArrangeView() {
+			const leaving = this.arrangingView;
+			this.arrangingView = !this.arrangingView;
+			if (leaving) {
+				this.saveViewUserLayouts();
+			}
+		},
+
 		// Expose the shared grid helpers to the template (grid mode + auto-body).
 		cnGridCellStyle,
 		hasGridRow,