@conduction/nextcloud-vue 2.69.0 → 2.70.0

package/src/schemas/app-manifest-v2.schema.json

@@ -3,7 +3,7 @@
 	"$id": "https://raw.githubusercontent.com/ConductionNL/nextcloud-vue/main/src/schemas/app-manifest-v2.schema.json",
 	"title": "Conduction App Manifest v2",
 	"description": "v2 schema for the JSON-driven page and navigation manifest consumed by @conduction/nextcloud-vue. Introduces a uniform widgets[] array on every page type with a per-slot grid coordinate system, a typed actions[] discriminator, and the required $schema field for version detection. v1 manifests continue to validate against app-manifest.schema.json (unchanged).",
-	"version": "2.51.0",
+	"version": "2.52.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -1569,6 +1569,11 @@
 						"href": { "type": "string" }
 					}
 				},
+				"showButtons": {
+					"type": "boolean",
+					"default": true,
+					"description": "`false` drops the widget's footer links (its definition's `buttons`, e.g. a calendar's \"More events\"), for a placement whose card says enough without them (zuiddrecht-pixel-gaps-3)."
+				},
 				"sizeToContent": {
 					"type": ["boolean", "integer"],
 					"minimum": 1,
@@ -2195,7 +2200,8 @@
 												}
 											},
 											"emptyText": { "type": "string", "description": "Text of a day without items." },
-											"weekOffset": { "type": "integer", "description": "Whole weeks from the current one (1 = next week)." }
+											"weekOffset": { "type": "integer", "description": "Whole weeks from the current one (1 = next week)." },
+											"inset": { "type": "boolean", "default": false, "description": "Draw the strip inside the board's inset (16px above, 24px at the sides, 22px below) instead of from card edge to card edge (zuiddrecht-pixel-gaps-3). Theme hook --cn-widget-board-inset." }
 										}
 									}
 								}
@@ -2246,7 +2252,8 @@
 											},
 											"order": { "type": "array", "items": { "type": "string" }, "description": "Group keys in the order they render. Unlisted groups follow; a listed key without records shows 0." },
 											"labels": { "type": "object", "additionalProperties": { "type": "string" }, "description": "The label of a group key." },
-											"emptyText": { "type": "string", "description": "Shown when the total is 0." }
+											"emptyText": { "type": "string", "description": "Shown when the total is 0." },
+											"inset": { "type": "boolean", "default": false, "description": "Draw the bar and legend inside the board's inset (16px above, 24px at the sides, 22px below) instead of from card edge to card edge (zuiddrecht-pixel-gaps-3). Theme hook --cn-widget-board-inset." }
 										}
 									}
 								}
@@ -3681,7 +3688,12 @@
 						"showWidgetActions": {
 							"type": "boolean",
 							"default": true,
-							"description": "type='dashboard': `false` drops the overflow Actions menu from every widget that does not set `showActions` itself, for a dashboard whose widget headers carry a header link and nothing else (zuiddrecht-pixel-gaps-2). Maps to CnDashboardPage `showWidgetActions`."
+							"description": "type='dashboard' and type='detail': `false` drops the overflow Actions menu from every widget that does not set `showActions` itself, for a dashboard whose widget headers carry a header link and nothing else (zuiddrecht-pixel-gaps-2), or a record page whose data cards carry none (zuiddrecht-pixel-gaps-3; a card with an Add action keeps it). Maps to CnDashboardPage / CnDetailPage `showWidgetActions`."
+						},
+						"gridFloat": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='dashboard': `false` packs widgets upward (GridStack `float: false`), so a size-to-content widget that shrinks closes the gap under it instead of leaving an empty band (zuiddrecht-pixel-gaps-3). Maps to CnDashboardPage `gridFloat`."
 						},
 						"showTitle": {
 							"type": "boolean",
@@ -3692,6 +3704,33 @@
 							"type": "string",
 							"description": "type='index': an i18n key for the description line with `{total}` replaced by the collection's total, e.g. \"{total} open cases\" (zuiddrecht-pixel-gaps). Shown in place of `description` once a total is known. Maps to CnIndexPage `countSubtitle`."
 						},
+						"showTitleIcon": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='index': `false` drops the icon before the page title, for a title that stands alone as the board draws it (zuiddrecht-pixel-gaps-3). Maps to CnIndexPage `showTitleIcon`."
+						},
+						"showCount": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='index': `false` drops the actions bar's \"Showing 20 of 258\" line, for a page whose title line already gives the total through `countSubtitle` (zuiddrecht-pixel-gaps-3). Maps to CnIndexPage `showCount`."
+						},
+						"headerButtons": {
+							"type": "array",
+							"description": "type='index': buttons beside the page title, as the board's \"Export\" and \"New case\" (zuiddrecht-pixel-gaps-3). `action` is `add` (the Add flow; the label defaults to the Add label), `export` (the export leaf in `format`, else the export dialog), `import`, `refresh`, or the id of a `headerActions` entry. Shown only with `showTitle`; when they show, the actions bar drops its Views and Actions menus, and the Add button and Export menu when a button takes their action. Maps to CnIndexPage `headerButtons`.",
+							"items": {
+								"type": "object",
+								"additionalProperties": false,
+								"required": ["action"],
+								"properties": {
+									"id": { "type": "string", "minLength": 1 },
+									"label": { "type": "string", "minLength": 1, "description": "i18n key; optional for `add`." },
+									"action": { "type": "string", "minLength": 1 },
+									"variant": { "type": "string", "enum": ["primary", "secondary"], "default": "secondary" },
+									"icon": { "type": "string", "minLength": 1, "description": "MDI icon name." },
+									"format": { "type": "string", "enum": ["csv", "excel"], "default": "csv", "description": "For `export`." }
+								}
+							}
+						},
 						"showTypeEyebrow": {
 							"type": "boolean",
 							"default": true,
@@ -3707,7 +3746,9 @@
 								"route": { "type": "string" },
 								"params": { "type": "object", "additionalProperties": true },
 								"href": { "type": "string" },
-								"icon": { "type": "string", "minLength": 1, "description": "Optional MDI icon name (e.g. `Home`) drawn as the first crumb instead of the label, which then becomes its accessible name (zuiddrecht-pixel-gaps-2). Without it the label shows as text." }
+								"icon": { "type": "string", "minLength": 1, "description": "Optional MDI icon name (e.g. `Home`) drawn as the first crumb instead of the label, which then becomes its accessible name (zuiddrecht-pixel-gaps-2). Without it the label shows as text." },
+								"currentField": { "type": "string", "minLength": 1, "description": "A field of the record (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 (zuiddrecht-pixel-gaps-3)." },
+								"separator": { "type": "string", "minLength": 1, "maxLength": 3, "description": "Text drawn between the crumbs (e.g. `/`) instead of the chevron (zuiddrecht-pixel-gaps-3)." }
 							}
 						},
 						"headerCard": {

package/src/utils/capabilityComparison.js

@@ -22,6 +22,34 @@
  * @module utils/capabilityComparison
  */
 
+/*
+ * `process.env.NODE_ENV` is substituted by every consuming app's bundler at
+ * build time (webpack's DefinePlugin, rollup's replace); see NcSelectTags.js.
+ */
+/* global process */
+
+let deprecationWarned = false
+
+/**
+ * Warn once per page load, in a development build only, that the in-app
+ * capability comparison is deprecated. Called by CnFeaturesAndRoadmapPage,
+ * CnFeaturesAndRoadmapView and CnCapabilityTable when a comparison is
+ * actually given, so an app that passes none hears nothing.
+ *
+ * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-the-in-app-capability-comparison-is-deprecated
+ * @param {string} source What carried the comparison, for the message.
+ * @return {boolean} True when this call printed the warning.
+ */
+export function warnCapabilityComparisonDeprecated(source) {
+	if (deprecationWarned || process.env.NODE_ENV === 'production') {
+		return false
+	}
+	deprecationWarned = true
+	// eslint-disable-next-line no-console -- a deliberate deprecation notice to the developer integrating the component
+	console.warn(`[nextcloud-vue] ${source} is deprecated: the in-app capability comparison (capabilityComparison, the features_roadmap_capabilities initial state, CnCapabilityTable) will be removed in a future major version. Publish the comparison on the app's docs site and link to it instead.`)
+	return true
+}
+
 /**
  * Ratings in the order they are counted and rendered.
  *