@conduction/nextcloud-vue 2.82.0 → 2.83.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.92.0",
+	"version": "2.93.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -4309,7 +4309,7 @@
 									"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`." },
-									"items": { "type": "array", "minItems": 1, "uniqueItems": true, "items": { "type": "string", "minLength": 1 }, "description": "For `actions-menu`: the menu's entries, in order. Each is `header-actions` (every header action), the id of one `headerActions` entry, or a built-in of the actions bar's own menu, which the bar drops while header buttons show: `import`, `export`, `refresh`, `copy-selected`, `delete-selected` (disabled until a row is selected) or `documentation` (a link to the page's documentationUrl, left out without one). An unknown name is left out. Absent: the header actions only (screens-index-header-actions-menu, 2.90.0)." }
+									"items": { "type": "array", "minItems": 1, "items": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": false, "required": ["heading"], "properties": { "heading": { "type": "string", "minLength": 1, "description": "i18n key of a group heading." } } } ] }, "description": "For `actions-menu`: the menu's entries, in order. Each is `header-actions` (every header action), the id of one `headerActions` entry, or a built-in of the actions bar's own menu, which the bar drops while header buttons show: `import`, `export`, `refresh`, `copy-selected`, `delete-selected` (disabled until a row is selected) or `documentation` (a link to the page's documentationUrl, left out without one). An unknown name is left out. Absent: the header actions only (screens-index-header-actions-menu, 2.90.0). Entries can be grouped: `{ \"heading\": \"<i18n key>\" }` draws a group heading and `\"separator\"` a rule, each only when an entry follows it, so a group whose entries are all left out leaves no empty heading (screens-index-header-menu-headings, 2.93.0)." }
 								}
 							}
 						},

package/src/utils/fetchAggregate.js

@@ -37,11 +37,34 @@ export function flattenAggFilter(target, filter, ctx) {
 				target[`filter[${k}][${op}]`] = ov
 			}
 		} else if (v !== '' && v !== null && v !== undefined) {
-			target[`filter[${k}]`] = v
+			target[aggFilterParam(k)] = v
 		}
 	}
 }
 
+/**
+ * Matches a filter key that spells its operator, `field[op]`.
+ *
+ * @type {RegExp}
+ */
+const OPERATOR_KEY = /^(.+)\[([A-Za-z_]+)\]$/
+
+/**
+ * The query parameter of one plain filter key. A key that spells its operator
+ * (`scheduledDate[gte]`, the flat form a list page and a lens use) goes out as
+ * `filter[scheduledDate][gte]`, the form the aggregation endpoint reads, and
+ * not as `filter[scheduledDate[gte]]`, a field it does not have, which counted
+ * 0. Any other key goes out as `filter[key]`.
+ *
+ * @spec openspec/changes/screens-stats-block-operator-keys/specs/stats-block/spec.md#requirement-a-stats-block-filter-can-spell-its-operator-in-the-key
+ * @param {string} key The filter key.
+ * @return {string} The query parameter name.
+ */
+export function aggFilterParam(key) {
+	const match = OPERATOR_KEY.exec(key)
+	return match ? `filter[${match[1]}][${match[2]}]` : `filter[${key}]`
+}
+
 /**
  * Fetch one aggregated scalar from OpenRegister.
  *

package/src/utils/switchValues.js

@@ -0,0 +1,59 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * A switch's value map: what a switch reads as "on" and what it writes for on
+ * and off. Without a map a switch is a boolean, as before. With `values:
+ * { on, off }` it reads a field stored as `"1"`/`"0"` or `"true"`/`"false"`
+ * (an app config flag) and writes those values back.
+ *
+ * @module utils/switchValues
+ * @spec openspec/changes/screens-switch-value-map/specs/switch-rows/spec.md#requirement-a-switch-can-read-and-write-a-value-map
+ */
+
+/**
+ * The value map of a switch, or null when it has none (a boolean switch).
+ *
+ * @param {unknown} values The declared `values`.
+ * @return {{on: unknown, off: unknown}|null} The map.
+ */
+export function switchValueMap(values) {
+	if (!values || typeof values !== 'object' || Array.isArray(values) || values.on === undefined) {
+		return null
+	}
+	return { on: values.on, off: values.off === undefined ? null : values.off }
+}
+
+/**
+ * Whether a stored value reads as "on". Without a map only `true` does; with
+ * one, the `on` value does, compared as text so `1` and `"1"` are the same.
+ *
+ * @param {unknown} stored The stored value.
+ * @param {unknown} values The declared `values`.
+ * @return {boolean} True when the switch shows on.
+ */
+export function switchIsOn(stored, values) {
+	const map = switchValueMap(values)
+	if (!map) {
+		return stored === true
+	}
+	if (stored === undefined || stored === null) {
+		return false
+	}
+	return stored === map.on || String(stored) === String(map.on)
+}
+
+/**
+ * The value a switch writes for a state.
+ *
+ * @param {boolean} on The switch state.
+ * @param {unknown} values The declared `values`.
+ * @return {unknown} `true`/`false` without a map, else the map's `on` / `off`.
+ */
+export function switchStoredValue(on, values) {
+	const map = switchValueMap(values)
+	if (!map) {
+		return on === true
+	}
+	return on ? map.on : map.off
+}