@conduction/nextcloud-vue 2.100.0 → 2.102.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.123.0",
+	"version": "2.125.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -98,6 +98,7 @@
 							"title": { "type": "string" },
 							"body": { "type": "string", "description": "info: explanatory copy." },
 							"note": { "type": "string", "minLength": 1, "description": "choice: a footnote under the options, translated like body." },
+							"visibleWhen": { "description": "Offer the step only when the setup status says so: a dotted path into the setup status document whose value must be truthy, or { path, equals } for an exact value. Hidden while the status loads.", "oneOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "required": ["path"], "additionalProperties": false, "properties": { "path": { "type": "string", "minLength": 1 }, "equals": {} } } ] },
 							"footnote": { "type": "string", "minLength": 1, "description": "choice: the same footnote under another name; note wins when both are set." },
 							"required": { "type": "boolean", "default": false, "description": "When true the step gates the app until done." },
 							"schema": { "description": "config-fields: a JSON Schema ref (string) or inline object rendered via fieldsFromSchema." },
@@ -2220,7 +2221,8 @@
 									},
 									"emptyLabel": { "type": "string", "description": "Empty-state message rendered instead of the chart when the resolved series contain no data points." },
 									"barMax": { "type": "number", "exclusiveMinimum": 0, "description": "chartKind 'bar-list': the value a full track stands for (100 for percentages). Omitted = the largest value." },
-									"footnote": { "type": "string", "description": "chartKind 'bar-list' or 'matrix': a line under the rows, through the host's translate." },
+									"footnote": { "type": "string", "description": "A line under the chart, through the host's translate: under the rows of a bar-list or matrix, and under the plot of a line, area or bar chart." },
+									"emptyCellLabel": { "type": "string", "description": "chartKind 'matrix': the text of a cell without a value (\"geen\"), through the host's translate. Empty leaves the cell blank. Passed through to CnChartWidget." },
 									"highlight": {
 										"type": "object",
 										"additionalProperties": false,
@@ -3737,7 +3739,58 @@
 							"enum": ["flows", "flowRuns", "tasks", "endpoint", "search", "users", "organisations"],
 							"description": "Name a registered NON-OBJECT entity collection for a type='index' page, instead of register+schema. Deliberately NOT called `source`: that key is already taken on page config and is polymorphic (a URL string in some manifests, an object with `params` in others), so reusing it would give one key two meanings and break six deployed shillinq pages. A flow definition is deliberately not an OpenRegister object, so an index had nothing to bind to and such lists became bespoke type='custom' pages. With a source the index loads the list itself. Takes precedence over register/schema; non-empty `objects` still wins over both. Registered sources live in src/composables/indexSources.js. `tasks` lists the viewer's task inbox from OpenRegister's flow-tasks read (cn-tasks-entity-source). `organisations` lists the OpenRegister organisations the viewer belongs to. On a type='detail' page a source that reads one record (today `organisations`) loads the record whose id is the route's objectId, instead of register+schema, and feeds the header, pills, widgets and @objectId / @object.* tokens like a fetched object (organisations-entity-source)."
 						},
-						"sourceConfig": { "type": "object", "additionalProperties": true, "description": "type='index' with `entitySource`: what the named source loads with. `endpoint`: `url` (an app path, required) and `rowsPath` (default `results`); its other keys go along as query parameters. `search`: `kinds` (`{ id, label, register, schema, titleField?, subtitleField?, statusField?, href?, limit? }` or `{ id, label, files: true }`), `term` and `termQuery` (default `q`). `users`: `defaultGroup`, `functionField`, `rolesField`. `flows` / `tasks`: `app`, `scope`. Maps to CnIndexPage `sourceConfig`.", "properties": { "url": { "type": "string", "minLength": 1 }, "rowsPath": { "type": "string", "minLength": 1 }, "kinds": { "type": "array", "items": { "type": "object", "required": ["id"], "additionalProperties": true, "properties": { "id": { "type": "string", "minLength": 1 }, "label": { "type": "string" }, "register": { "type": "string" }, "schema": { "type": "string" }, "files": { "type": "boolean" } } } }, "term": { "type": "string" }, "termQuery": { "type": "string", "minLength": 1 }, "defaultGroup": { "type": "string", "minLength": 1 } } },
+						"bulkBandAlways": { "type": "boolean", "default": false, "description": "type='index', board look: draw the bulk band (its actions and hint) before a selection too, its buttons disabled until rows are selected (DqZaken, DqWerkbord). Maps to CnIndexPage `bulkBandAlways`." },
+						"quickFilterPlacement": { "type": "string", "enum": ["", "toolbar"], "default": "", "description": "type='index': where the quick-filter chips sit. `toolbar` keeps them on one row with the Filter button and the view switch beside a side panel, the chips that do not fit behind the overflow chip (DqTeamwachtrij). Maps to CnIndexPage `quickFilterPlacement`." },
+						"rowClass": {
+							"type": "array",
+							"description": "type='index': per-row CSS class rules, compiled into the table's rowClass function as on the object-table widget. Each rule { when: { field, op?, value }, class } adds `class` to a row whose `field` (a dot-path) compares to `value` with `op` (default eq; the visibleWhen operators and tokens such as `@today`, with two dates compared as moments), e.g. an overdue task `{ when: { field: \"dueAt\", op: \"lt\", value: \"@today\" }, class: \"cn-row--overdue\" }`. Maps to CnIndexPage `rowClass`.",
+							"items": {
+								"type": "object",
+								"additionalProperties": false,
+								"required": [
+									"when",
+									"class"
+								],
+								"properties": {
+									"when": {
+										"type": "object",
+										"additionalProperties": false,
+										"required": [
+											"field",
+											"value"
+										],
+										"description": "The predicate evaluated against the row (shared visibleWhen grammar, LOCAL form).",
+										"properties": {
+											"field": {
+												"type": "string",
+												"description": "Dot-path into the row."
+											},
+											"op": {
+												"type": "string",
+												"enum": [
+													"eq",
+													"neq",
+													"gt",
+													"gte",
+													"lt",
+													"lte"
+												],
+												"default": "eq",
+												"description": "Comparison operator (default eq)."
+											},
+											"value": {
+												"description": "Literal right-hand side of the comparison."
+											}
+										}
+									},
+									"class": {
+										"type": "string",
+										"description": "CSS class added to the row when `when` holds."
+									}
+								}
+							}
+						},
+						"sourceConfig": { "type": "object", "additionalProperties": true, "description": "type='index' with `entitySource`: what the named source loads with. `endpoint`: `url` (an app path, required) and `rowsPath` (default `results`); its other keys go along as query parameters. `search`: `kinds` (`{ id, label, register, schema, titleField?, subtitleField?, statusField?, href?, limit? }` or `{ id, label, files: true }`), `term` and `termQuery` (default `q`). `users`: `defaultGroup`, `functionField`, `rolesField`. `flows` / `tasks`: `app`, `scope`. Maps to CnIndexPage `sourceConfig`.", "properties": { "url": { "type": "string", "minLength": 1 }, "rowsPath": { "type": "string", "minLength": 1 }, "kinds": { "type": "array", "items": { "type": "object", "required": ["id"], "additionalProperties": true, "properties": { "id": { "type": "string", "minLength": 1 }, "label": { "type": "string" }, "register": { "type": "string" }, "schema": { "type": "string" }, "files": { "type": "boolean" } } } }, "term": { "type": "string" }, "termQuery": { "type": "string", "minLength": 1 }, "defaultGroup": { "type": "string", "minLength": 1 }, "limit": { "type": "integer", "minimum": 1, "description": "A paging source: rows per page (20 by default); the pager moves through the pages." } } },
 						"app": {
 							"type": "string",
 							"description": "Scopes a named `entitySource` to one app (e.g. entitySource='flows' with app='dossiq' lists that app's flows)."
@@ -4372,6 +4425,35 @@
 							"default": true,
 							"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). When the key is not set a detail page keeps the menu, except under the board look, where side cards carry none (screens-detail-page-parity). Maps to CnDashboardPage / CnDetailPage `showWidgetActions`."
 						},
+						"pageFilters": {
+							"type": "array",
+							"description": "type='dashboard': page-level filter controls in the header. Each selection is written into the page's workspace context, so a widget reads it through a `@page.<key>` / `@workspace.<key>` token (an endpoint widget also in its `responsePath`). Maps to the CnDashboardPage `pageFilters` prop.",
+							"items": {
+								"type": "object",
+								"required": ["key", "options"],
+								"additionalProperties": false,
+								"properties": {
+									"key": { "type": "string", "minLength": 1, "description": "Workspace-context key written on change (the `@page.<key>` / `@workspace.<key>` token name)." },
+									"label": { "type": "string", "description": "Control label (i18n key or plain text)." },
+									"type": { "type": "string", "enum": ["select"], "default": "select", "description": "Control type, carried over from v1." },
+									"control": { "type": "string", "enum": ["select", "segmented"], "default": "select", "description": "How the filter is drawn: a select, or a compact segmented group." },
+									"placement": { "type": "string", "enum": ["row", "description"], "default": "row", "description": "Where the filter sits: in the header's filter row, or (a segmented group) on the description line after the period group (DqProcesanalyse)." },
+									"default": { "type": ["string", "number"], "description": "Initial value seeded into the context on mount; the first option's value when omitted." },
+									"options": {
+										"type": "array",
+										"items": {
+											"type": "object",
+											"required": ["value", "label"],
+											"additionalProperties": false,
+											"properties": {
+												"value": { "type": ["string", "number"], "description": "Value written into the context when picked." },
+												"label": { "type": "string", "description": "Display text (i18n key or plain text)." }
+											}
+										}
+									}
+								}
+							}
+						},
 						"kpiRow": {
 							"type": "array",
 							"items": { "type": "string" },

package/src/utils/builtInFormatters.js

@@ -379,25 +379,45 @@ const CONNECTION_STATUS_LABELS = {
 	error: 'Error',
 }
 
+/**
+ * The short labels `formatterOptions.short` draws (board DqInstellingen
+ * "Aan / Uit / Fout"): a connection that works in some form is on, one that
+ * does not run is off, and a failing one is an error.
+ */
+const CONNECTION_STATUS_SHORT_LABELS = {
+	configured: 'On',
+	limited: 'On',
+	simulated: 'On',
+	unconfigured: 'Off',
+	disabled: 'Off',
+	unavailable: 'Off',
+	error: 'Error',
+}
+
 /**
  * Connection status formatter (`connectionStatus` registry key) for the
  * fleet connection registry. Renders one of the seven stored status values
  * as its translated label through the library's own slug (`nextcloud-vue`).
+ * With `formatterOptions.short` it renders the board's three short labels
+ * instead: On (configured, limited, simulated), Off (not configured,
+ * switched off, not available) and Error.
  *
  * An unknown value passes through unchanged, so a status added later still
  * shows as its raw value instead of an empty cell. Null and undefined render
  * as `''`. Never throws.
  *
  * @param {unknown} value The stored status value.
+ * @param {object} [row] The row (unused).
+ * @param {object} [property] The column's property (unused).
+ * @param {{short?: boolean}} [options] The column's `formatterOptions`.
  * @return {string} The translated label, or the value itself when it is not one of the seven.
  */
-export function formatConnectionStatus(value) {
+export function formatConnectionStatus(value, row, property, options) {
 	if (value === null || value === undefined) {
 		return ''
 	}
-	const label = Object.hasOwn(CONNECTION_STATUS_LABELS, value)
-		? CONNECTION_STATUS_LABELS[value]
-		: null
+	const labels = options && options.short === true ? CONNECTION_STATUS_SHORT_LABELS : CONNECTION_STATUS_LABELS
+	const label = Object.hasOwn(labels, value) ? labels[value] : null
 	return label ? t('nextcloud-vue', label) : String(value)
 }
 

package/src/utils/languageMapText.js

@@ -0,0 +1,46 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+
+import { getLanguage } from '@nextcloud/l10n'
+
+/**
+ * The user's Nextcloud language as a bare code (`nl_NL` reads `nl`), or ''.
+ *
+ * @return {string} The code.
+ */
+function userLanguage() {
+	try {
+		return String(getLanguage() || '').split(/[-_]/)[0].toLowerCase()
+	} catch {
+		return ''
+	}
+}
+
+/**
+ * The text of a value that may be a language map (`{ nl: 'Ontvangst', en:
+ * 'Intake' }`), in the user's Nextcloud language, then Dutch, then English,
+ * then the first text it holds. A plain value comes back as text; anything
+ * else as ''.
+ *
+ * @param {(string|number|object|null|undefined)} value The value.
+ * @return {string} The text.
+ * @spec openspec/changes/grouped-cards-widget/specs/grouped-cards-widget/spec.md#requirement-a-widget-draws-groups-of-cards-from-an-endpoint
+ */
+export function languageMapText(value) {
+	if (typeof value === 'string' || typeof value === 'number') {
+		return String(value)
+	}
+	if (!value || typeof value !== 'object' || Array.isArray(value)) {
+		return ''
+	}
+	const language = userLanguage()
+	for (const key of [language, 'nl', 'en']) {
+		if (key && typeof value[key] === 'string' && value[key] !== '') {
+			return value[key]
+		}
+	}
+	const first = Object.values(value).find((text) => typeof text === 'string' && text !== '')
+	return first || ''
+}

package/src/utils/libraryWidgetKeys.js

@@ -71,6 +71,8 @@ export const BUILT_IN_WIDGET_KEYS = Object.freeze([
 	'header',
 	'text',
 	'divider',
+	'saved-view-alert',
+	'exports',
 ])
 
 /**
@@ -109,6 +111,7 @@ export const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'files',
 	'flow-runs',
 	'gauge',
+	'grouped-cards',
 	'header',
 	'image',
 	'interaction-form',

package/src/utils/mapList.js

@@ -0,0 +1,67 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+import { isBadgeVariant } from './badgeVariants.js'
+import { fillTemplate } from './fillTemplate.js'
+import { readPath } from './readPath.js'
+
+/**
+ * The numbered list beside an index map (DqZakenKaart): one entry per row
+ * that has a place on the map, numbered in list order so the number on the
+ * pin and the number in the list are the same, and the rows without one.
+ *
+ * `spec` is `mapConfig.list`: `{ title, sub?, pills?: [{ path?, text?, map?,
+ * colorMap? }], due? }`. `title`, `sub` and `due` are field templates
+ * (`"{title}"`, `"{address} · {identifier}"`, `"{deadline|date}"`), already
+ * translated by the caller; a pill reads `path` (or shows `text`), maps it
+ * through `map`, and takes its tone from `colorMap` by the raw value.
+ *
+ * @param {Array<object>} rows The rows, in display order.
+ * @param {object} spec The list declaration.
+ * @param {object} options How to read a row.
+ * @param {string} options.rowKey The row's key field.
+ * @param {Function} options.located Whether a row has a place on the map.
+ * @param {Function} [options.translate] The host's translate, for pill labels.
+ * @return {{items: Array<{key: string, n: number, row: object, title: string, sub: string, due: string, pills: Array<{label: string, variant: string}>}>, missing: Array<object>}}
+ */
+export function mapListItems(rows, spec, { rowKey, located, translate = (text) => text }) {
+	const items = []
+	const missing = []
+	const list = spec && typeof spec === 'object' ? spec : {}
+	for (const row of Array.isArray(rows) ? rows : []) {
+		if (!located(row)) {
+			missing.push(row)
+			continue
+		}
+		const pills = (Array.isArray(list.pills) ? list.pills : [])
+			.map((pill) => {
+				if (!pill || typeof pill !== 'object') {
+					return null
+				}
+				const raw = typeof pill.path === 'string' && pill.path !== '' ? readPath(row, pill.path) : undefined
+				const mapped = pill.map && (typeof raw === 'string' || typeof raw === 'number') && Object.hasOwn(pill.map, raw) ? pill.map[raw] : undefined
+				const text = mapped ?? pill.text ?? raw
+				if (typeof text !== 'string' && typeof text !== 'number') {
+					return null
+				}
+				const label = translate(String(text))
+				if (label === '') {
+					return null
+				}
+				const tone = pill.colorMap && (typeof raw === 'string' || typeof raw === 'number') ? pill.colorMap[raw] : pill.variant
+				return { label, variant: isBadgeVariant(tone) ? tone : 'default' }
+			})
+			.filter(Boolean)
+		items.push({
+			key: String(row[rowKey]),
+			n: items.length + 1,
+			row,
+			title: fillTemplate(list.title || '', row),
+			sub: fillTemplate(list.sub || '', row),
+			due: fillTemplate(list.due || '', row),
+			pills,
+		})
+	}
+	return { items, missing }
+}

package/src/utils/rowClassRules.js

@@ -0,0 +1,39 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+import { compareVisibleWhen, readVisibleWhenPath } from './visibleWhen.js'
+
+/**
+ * Compile a row-class declaration into the `(row) => string` CnDataTable
+ * takes. A function passes straight through. An array of rules
+ * `[{ when: { field, op?, value }, class }]` adds each rule's `class` to a row
+ * whose `field` (a dot-path) compares to `value` with `op` (`eq` by default;
+ * the shared `visibleWhen` operators, `@today` and the other tokens included),
+ * every matching class space-joined: an overdue row can be marked from the
+ * manifest (`{ when: { field: "dueAt", op: "lt", value: "@today" }, class:
+ * "cn-row--overdue" }`). Anything else, or an empty list, is null.
+ *
+ * @param {Function|Array<{when: {field: string, op?: string, value: unknown}, class: string}>|null} rowClass The declaration.
+ * @return {?(row: object) => string} The row-class function, or null.
+ */
+export function compileRowClass(rowClass) {
+	if (typeof rowClass === 'function') {
+		return rowClass
+	}
+	if (!Array.isArray(rowClass) || rowClass.length === 0) {
+		return null
+	}
+	const rules = rowClass.filter((rule) => rule && typeof rule.class === 'string' && rule.class !== '')
+	return (row) => {
+		const classes = []
+		for (const rule of rules) {
+			const when = rule.when || {}
+			const actual = readVisibleWhenPath(row, when.field)
+			if (compareVisibleWhen(actual, when.op || 'eq', when.value)) {
+				classes.push(rule.class)
+			}
+		}
+		return classes.join(' ')
+	}
+}