@conduction/nextcloud-vue 2.79.0 → 2.81.0

package/src/integrations/offline/fieldCollectionHelpers.js

@@ -46,11 +46,71 @@ export function classifyGps(fix, available = true) {
 	return { quality: 'good', source: 'sensor', warning: null }
 }
 
+/**
+ * Read a checklist template into the leaf's flat item contract.
+ *
+ * A consuming app's template does not have to carry `items[]` with
+ * `questionId` / `text` / `type`. Its `offlineConfig` names where those live:
+ * `sectionsField` when the items sit inside ordered sections, and the
+ * `item*Field` keys for the item's key, text and type. `itemTypeMap` translates
+ * the app's own type words onto the leaf's (`yes_no`, `photo_required`, or any
+ * other word, which renders as free text). `photoRequiredField` and
+ * `photoRequiredValue` mark an item whose answer also needs a photo.
+ *
+ * The template's own keys are kept, so the id and version stay readable; only
+ * `items` is replaced by the normalised list.
+ *
+ * @param {object|null} template The template as cached.
+ * @param {object}      [config] The leaf's offline config.
+ *
+ * @return {object|null} The template with flat `items[]`, or null.
+ */
+export function normaliseChecklistTemplate(template, config = {}) {
+	if (template === null || typeof template !== 'object') {
+		return null
+	}
+
+	const keyField = config.itemKeyField || 'questionId'
+	const textField = config.itemTextField || 'text'
+	const typeField = config.itemTypeField || 'type'
+	const typeMap = (config.itemTypeMap && typeof config.itemTypeMap === 'object') ? config.itemTypeMap : {}
+
+	const sections = config.sectionsField ? template[config.sectionsField] : null
+	const raw = Array.isArray(sections)
+		? sections.flatMap((section) => (Array.isArray(section?.items) ? section.items : []))
+		: (Array.isArray(template.items) ? template.items : [])
+
+	const items = []
+	for (const item of raw) {
+		if (item === null || typeof item !== 'object') {
+			continue
+		}
+		const questionId = String(item[keyField] ?? '')
+		if (questionId === '') {
+			continue
+		}
+		const ownType = item[typeField]
+		const photoRequired = Boolean(config.photoRequiredField)
+			&& item[config.photoRequiredField] === config.photoRequiredValue
+		items.push({
+			...item,
+			questionId,
+			text: item[textField] ?? item.text ?? questionId,
+			type: typeMap[ownType] ?? ownType ?? 'text',
+			required: item.required === true,
+			photoRequired,
+		})
+	}
+
+	return { ...template, items }
+}
+
 /**
  * Validate a set of checklist answers against the template's required items.
  *
- * A `required` item must have a non-empty answer; a `photo_required` item must
- * additionally have at least one evidence reference. Returns the per-question
+ * A `required` item must have a non-empty answer; a `photo_required` item, and
+ * any item flagged `photoRequired` by {@link normaliseChecklistTemplate}, must
+ * have at least one evidence reference. Returns the per-question
  * blocking errors so the UI can prevent save (and the engine never queues an
  * invalid result).
  *
@@ -66,7 +126,7 @@ export function validateChecklistAnswers(template, answersByQuestion) {
 	const errors = []
 
 	for (const item of items) {
-		if (item?.required !== true) {
+		if (item?.required !== true && item?.photoRequired !== true) {
 			continue
 		}
 		const entry = answers[item.questionId] ?? {}
@@ -80,7 +140,12 @@ export function validateChecklistAnswers(template, answersByQuestion) {
 			continue
 		}
 
-		if (answer === undefined || answer === null || String(answer).trim() === '') {
+		if (item.photoRequired === true && evidenceRefs.length === 0) {
+			errors.push({ questionId: item.questionId, message: t('nextcloud-vue', 'Photo required for this question') })
+			continue
+		}
+
+		if (item.required === true && (answer === undefined || answer === null || String(answer).trim() === '')) {
 			errors.push({ questionId: item.questionId, message: t('nextcloud-vue', 'This question is required') })
 		}
 	}

package/src/integrations/offline/index.js

@@ -60,10 +60,13 @@ export {
 	checklistProgress,
 	classifyGps,
 	GPS_POOR_ACCURACY_M,
+	normaliseChecklistTemplate,
 	syncIndicator,
 	validateChecklistAnswers,
 } from './fieldCollectionHelpers.js'
 
+export { buildChecklistSubmission, fillEndpoint } from './checklistSubmission.js'
+
 export {
 	CACHE_PREFIX,
 	cacheNameFor,

package/src/integrations/offline/offlineDb.js

@@ -257,10 +257,12 @@ export async function getPlanningMeta(register, schema, collection = 'planning')
  *
  * @param {object} operation                  The mutation operation.
  * @param {string} operation.deviceId         Owning device id (IDOR scope).
- * @param {string} operation.operationType    create / update / delete.
+ * @param {string} operation.operationType    create / update / delete / submit.
  * @param {string} operation.register         Target register slug or id.
  * @param {string} operation.schema           Target schema slug or id.
  * @param {string} [operation.targetId]       Existing object id (update/delete).
+ * @param {string} [operation.endpoint]       Path under the Nextcloud root a
+ *                                            `submit` row is POSTed to.
  * @param {object} [operation.payload]        The object body (create/update).
  *
  * @return {Promise<string>} The queued operation id.
@@ -275,6 +277,9 @@ export async function enqueueMutation(operation) {
 		register: operation.register,
 		schema: operation.schema,
 		targetId: operation.targetId ?? null,
+		// A `submit` operation replays to an app's own endpoint instead of the
+		// object API (see checklistSubmission.js); every other row has none.
+		endpoint: operation.endpoint ?? null,
 		payload: operation.payload ?? {},
 		queuedAt: operation.queuedAt || new Date().toISOString(),
 		attemptCount: 0,

package/src/integrations/offline/syncReplayService.js

@@ -35,7 +35,8 @@ function objectsUrl(register, schema) {
 }
 
 /**
- * Replay one queued mutation against the OR object API.
+ * Replay one queued mutation against the OR object API, or, for a row that
+ * names an `endpoint`, as one POST to that endpoint.
  *
  * @param {object} operation       The queue operation row.
  * @param {object} [offlineConfig] The leaf's offline config (`register`,
@@ -54,7 +55,12 @@ export async function replayOperation(operation, offlineConfig = {}) {
 
 	try {
 		let response
-		if (operation.operationType === 'create' || operation.operationType === 'upload') {
+		if (typeof operation.endpoint === 'string' && operation.endpoint !== '') {
+			// A run the app checks and stores itself (a completed task, say):
+			// one POST to its endpoint under the Nextcloud root. The endpoint
+			// decides access from what it has stored, as the object API does.
+			response = await axios.post(generateUrl(operation.endpoint), payload)
+		} else if (operation.operationType === 'create' || operation.operationType === 'upload') {
 			response = await axios.post(base, payload)
 		} else if (operation.operationType === 'update') {
 			response = await axios.put(`${base}/${operation.targetId}`, payload)

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.79.0",
+	"version": "2.89.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -760,8 +760,8 @@
 		},
 		"sentinelFilterToken": {
 			"type": "string",
-			"pattern": "^@(?:me(?:\\.(?:displayName|email))?|myGroups|now|today|monthStart|quarterStart|yearStart)$|^@today[+-][0-9]+d$",
-			"description": "Filter-value context: relative fetch-time tokens resolved by resolveFilterTokens (@me, @me.displayName, @me.email, @myGroups (the current user's group ids, an IN list), @now, @today, @today±Nd, @monthStart, @quarterStart, @yearStart). Mirrors SENTINEL_TOKEN_PATTERNS.filter in src/utils/sentinelTokens.js (byte-equality enforced by a unit test)."
+			"pattern": "^@(?:me(?:\\.(?:displayName|email))?|myGroups|now|today|monthStart|monthEnd|nextMonthStart|quarterStart|yearStart)$|^@today[+-][0-9]+d$",
+			"description": "Filter-value context: relative fetch-time tokens resolved by resolveFilterTokens (@me, @me.displayName, @me.email, @myGroups (the current user's group ids, an IN list), @now, @today, @today±Nd, @monthStart, @monthEnd, @nextMonthStart, @quarterStart, @yearStart). Mirrors SENTINEL_TOKEN_PATTERNS.filter in src/utils/sentinelTokens.js (byte-equality enforced by a unit test)."
 		},
 		"sentinelConfigToken": {
 			"type": "string",
@@ -803,6 +803,16 @@
 			"pattern": "^@answer\\.[A-Za-z][A-Za-z0-9_]*$",
 			"description": "form-live-values: another answer in the same form (@answer.<field>), read by a form field's assign rule and resolved client-side by CnFormPage / CnFormDialog. Mirrors SENTINEL_TOKEN_PATTERNS.answer."
 		},
+		"sentinelRowToken": {
+			"type": "string",
+			"pattern": "^@row\\.[A-Za-z][A-Za-z0-9_.@]*$",
+			"description": "Row context: a field of the row a row action runs on (@row.<field>, dot path allowed), read by the field-list widget's rowActions request url and payload (payload values resolve at any depth). Mirrors SENTINEL_TOKEN_PATTERNS.row."
+		},
+		"sentinelSubjectToken": {
+			"type": "string",
+			"pattern": "^@subject\\.[A-Za-z][A-Za-z0-9_.]*$",
+			"description": "Subject context: a field of the record an attention card names (the first row of its ordered `visibleWhen` source query), read by the banner widget's action route params and query (@subject.<field>, dot path allowed). Mirrors SENTINEL_TOKEN_PATTERNS.subject."
+		},
 		"sentinelTokenAny": {
 			"$comment": "Union of every canonical context plus the deprecated-during-window overlay. Single source the shared resolver + gate import.",
 			"anyOf": [
@@ -814,6 +824,8 @@
 				{ "$ref": "#/$defs/sentinelDeclarativeToken" },
 				{ "$ref": "#/$defs/sentinelVisibleWhenToken" },
 				{ "$ref": "#/$defs/sentinelAnswerToken" },
+				{ "$ref": "#/$defs/sentinelRowToken" },
+				{ "$ref": "#/$defs/sentinelSubjectToken" },
 				{ "$ref": "#/$defs/sentinelDeprecatedToken" }
 			]
 		},
@@ -1132,14 +1144,43 @@
 		"headerPill": {
 			"type": "object",
 			"additionalProperties": false,
-			"required": ["field"],
-			"description": "A pill in a detail page header, rendered through CnStatusBadge from one field of the record. Nothing renders while the field is empty.",
+			"anyOf": [
+				{ "required": ["field"] },
+				{ "required": ["text"] },
+				{ "required": ["countFrom"] }
+			],
+			"description": "A pill in a detail page header, rendered through CnStatusBadge: from one field of the record (`field`; nothing renders while it is empty), a constant (`text`), or a count of a related list (`countFrom` with `countLabel`; nothing renders at 0, while counting or after a failed count). screens-relation-pages, 2.85.0.",
 			"properties": {
 				"field": {
 					"type": "string",
 					"minLength": 1,
 					"description": "Dot-path to the value on the record."
 				},
+				"text": {
+					"type": "string",
+					"minLength": 1,
+					"description": "A constant label (an i18n key), such as \"Inwoner\" or \"Klant\". Used when `field` is not set."
+				},
+				"countFrom": {
+					"type": "object",
+					"additionalProperties": false,
+					"required": ["register", "schema"],
+					"description": "The list the pill counts with one list request (`_limit=1`, the response's `total`). `filter` values take the `@objectId` and `@object.<field>` tokens. Used when `field` is not set.",
+					"properties": {
+						"register": { "type": "string", "minLength": 1 },
+						"schema": { "type": "string", "minLength": 1 },
+						"filter": { "type": "object", "additionalProperties": true }
+					}
+				},
+				"countLabel": {
+					"type": "object",
+					"additionalProperties": false,
+					"description": "The count pill's label for one and for more, i18n keys with `{count}`: `{ \"one\": \"{count} lopende zaak\", \"other\": \"{count} lopende zaken\" }`.",
+					"properties": {
+						"one": { "type": "string", "minLength": 1 },
+						"other": { "type": "string", "minLength": 1 }
+					}
+				},
 				"colorMap": {
 					"type": "object",
 					"description": "Raw value to badge variant. Keys are matched ignoring case.",
@@ -1662,7 +1703,7 @@
 				"sizeToContent": {
 					"type": ["boolean", "integer"],
 					"minimum": 1,
-					"description": "Opt-in: hand this placement's height to whatever it renders, so a widget that decides AT RUNTIME it has nothing to show costs no row. `true` sizes purely to content; an integer is a row minimum. It makes gridHeight advisory for this widget — right for anything whose height is whatever it turned out to be (a banner whose condition is false, a list that came back empty), wrong for anything with a deliberate size. Maps to CnDashboardGrid's per-item `sizeToContent`."
+					"description": "Opt-in: hand this placement's height to whatever it renders, so a widget that decides AT RUNTIME it has nothing to show costs no row. `true` sizes purely to content; an integer sizes to content too but caps the height at that many rows (GridStack's maximum, NOT a minimum: content shorter than N rows is as short as it is, content taller is clipped at N). It makes gridHeight advisory for this widget — right for anything whose height is whatever it turned out to be (a banner whose condition is false, a list that came back empty), wrong for anything with a deliberate size. Maps to CnDashboardGrid's per-item `sizeToContent`."
 				},
 				"props": {
 					"type": "object",
@@ -1869,11 +1910,16 @@
 												"properties": {
 													"register": { "type": "string" },
 													"schema": { "type": "string" },
-													"filter": { "type": "object", "additionalProperties": true }
+													"filter": { "type": "object", "additionalProperties": true },
+													"order": {
+														"type": "object",
+														"additionalProperties": { "type": "string", "enum": ["asc", "desc"] },
+														"description": "Order of the query (`{ field: \"asc\" | \"desc\" }`), so the first result is the first of an ordered list. With it an attention card names that row: `{subject.<field>}` in its title, reason and kicker and `@subject.<field>` in an action route read it (screens-start-here-banner, 2.89.0)."
+													}
 												}
 											},
 											"field": { "type": "string", "description": "Dot-path into the response ('@total' or omitted = collection total for a source)." },
-											"op": { "type": "string", "enum": ["eq", "neq", "gt", "gte", "lt", "lte"], "default": "eq", "description": "Comparison operator." },
+											"op": { "type": "string", "enum": ["eq", "neq", "gt", "gte", "lt", "lte", "empty", "notEmpty"], "default": "eq", "description": "Comparison operator. `notEmpty` on `id` is the \"there is a first row\" test of a card that names one." },
 											"value": { "description": "Literal right-hand side of the comparison." }
 										}
 									},
@@ -1890,6 +1936,11 @@
 										"default": "banner",
 										"description": "How the banner renders. `banner` (default) is the note card. `attention` is a card with a severity edge, a kicker, a title, a reason line and up to two actions."
 									},
+									"stacked": {
+										"type": "boolean",
+										"default": false,
+										"description": "Attention card: put the actions under the text instead of beside it, with a 16px title (PqMijnWerk \"Begin hier\"; screens-start-here-banner, 2.89.0)."
+									},
 									"kicker": {
 										"type": "string",
 										"description": "Attention card: the small label above the title."
@@ -2155,9 +2206,27 @@
 											},
 											"style": {
 												"type": "string",
-												"enum": ["radio", "select"],
+												"enum": ["radio", "select", "chips", "toggle"],
 												"default": "radio",
-												"description": "Choice style: 'radio' (default) list or 'select' dropdown."
+												"description": "Choice style: 'radio' (default) list, 'select' dropdown, 'chips' (one compact segmented group with a count after each label; screens-page-lenses, 2.87.0) or 'toggle' (a switch writing `onValue` / `offValue`; screens-page-controls, 2.88.0)."
+											},
+											"layout": {
+												"type": "string",
+												"enum": ["start", "bar"],
+												"description": "'start' draws the start card; 'bar' draws `controls` side by side in one row (screens-page-controls, 2.88.0)."
+											},
+											"controls": {
+												"type": "array",
+												"items": { "type": "object", "additionalProperties": true },
+												"description": "With `layout: \"bar\"`: the bar's controls, each a workspace-filter content (chips, a toggle, a select) with its own `writes`. `align: \"end\"` pushes a control to the right edge (2.88.0)."
+											},
+											"onValue": { "description": "style 'toggle': the value written while the switch is on. Default true (2.88.0)." },
+											"offValue": { "description": "style 'toggle': the value written while the switch is off. Default false (2.88.0)." },
+											"align": { "type": "string", "enum": ["start", "end"], "description": "In a bar: 'end' pushes this control to the right edge (2.88.0)." },
+											"urlKey": {
+												"type": "string",
+												"minLength": 1,
+												"description": "Keep the choice in the address as `?<urlKey>=<value>` (replacing the history entry, keeping other query keys). The address wins over `default` on load, so a chip is linkable (screens-page-lenses, 2.87.0)."
 											},
 											"allLabel": {
 												"type": "string",
@@ -2170,7 +2239,7 @@
 											},
 											"options": {
 												"type": "array",
-												"description": "Static options — each { value, label, count? } (or { id, name } / bare strings, normalised).",
+												"description": "Static options — each { value, label, count?, countFrom? } (or { id, name } / bare strings, normalised). `countFrom` is `{ register, schema, filter? }`, or a list of those that are added up; the option shows that list's total (one list request each; none when it fails). screens-page-lenses, 2.87.0.",
 												"items": { "type": ["object", "string", "number"] }
 											},
 											"source": {
@@ -2582,6 +2651,14 @@
 					"type": "string",
 					"description": "open-form: overrides the create dialog's heading. Defaults to 'Create {schema title}'."
 				},
+				"formEyebrow": {
+					"type": "string",
+					"description": "open-form: the context line above the create dialog's heading (board look), e.g. the list the record joins. Through the host translate. Absent: no line."
+				},
+				"formSubtitle": {
+					"type": "string",
+					"description": "open-form: the sentence under the create dialog's heading (board look), e.g. which fields are required and what happens on save. Through the host translate. Absent: no sentence."
+				},
 				"size": {
 					"type": "string",
 					"enum": ["small", "normal", "large", "full"],
@@ -2888,15 +2965,20 @@
 						"filter": { "type": "object", "additionalProperties": true }
 					}
 				},
+				"workspace": {
+					"type": "string",
+					"minLength": 1,
+					"description": "WORKSPACE mode (screens-page-lenses, 2.87.0): the key of the page workspace context to compare, read at once with no request. A page control (a `workspace-filter` with `writes`) sets the key, and a dashboard widget carrying this condition appears and disappears as it changes. Honoured on a dashboard widget or KPI-row tile only, and as a top-level condition (not inside `all` / `any`)."
+				},
 				"field": {
 					"type": "string",
 					"description": "Dot-path to the compared value — into the endpoint body, the source's first result, or (LOCAL mode) the caller's object context."
 				},
 				"op": {
 					"type": "string",
-					"enum": ["eq", "neq", "gt", "gte", "lt", "lte", "empty", "notEmpty"],
+					"enum": ["eq", "neq", "gt", "gte", "lt", "lte", "empty", "notEmpty", "in"],
 					"default": "eq",
-					"description": "Comparison operator (default eq). eq/neq compare loosely-normalised primitives; ordering operators coerce both sides to Number. `empty` / `notEmpty` take no `value` and treat undefined, null, '' and an empty array alike — the one question eq cannot ask, because an unset field arrives in a shape that depends on the store and String(null) is the word 'null' rather than blank."
+					"description": "Comparison operator (default eq). eq/neq compare loosely-normalised primitives; ordering operators coerce both sides to Number. `in` holds when the value is one of the listed `value` array (2.87.0). `empty` / `notEmpty` take no `value` and treat undefined, null, '' and an empty array alike — the one question eq cannot ask, because an unset field arrives in a shape that depends on the store and String(null) is the word 'null' rather than blank."
 				},
 				"value": {
 					"description": "The right-hand side of the comparison, resolved through the shared @-token grammar so `@me` names the signed-in reader rather than a literal only the server knows. Omitted for `empty` / `notEmpty`."
@@ -2948,6 +3030,45 @@
 					"type": "array",
 					"items": { "type": "string" },
 					"description": "OpenRegister `_extend[]` values forwarded on the fetch (e.g. [\"calculations\"]) so read-time virtual/derived fields are hydrated and available as columns. Each entry is passed through verbatim."
+				},
+				"pageControls": { "$ref": "#/$defs/pageControls" }
+			}
+		},
+		"pageControls": {
+			"type": "object",
+			"additionalProperties": false,
+			"description": "screens-page-controls (2.88.0): which page controls a list widget (`record-list`, `object-table`) listens to, and what they mean for it. A page control is a `workspace-filter` select or switch that writes a workspace key. `sort` picks the list's sort from the key's value; `toggle` drops filter keys while the key is on. Without it the list ignores the page's controls.",
+			"properties": {
+				"sort": {
+					"type": "object",
+					"required": ["key", "map"],
+					"additionalProperties": false,
+					"description": "The workspace key a sort select writes, and what each of its values sorts by. A value with no entry leaves the list's own sort.",
+					"properties": {
+						"key": { "type": "string", "minLength": 1 },
+						"map": {
+							"type": "object",
+							"additionalProperties": {
+								"type": "object",
+								"required": ["field"],
+								"additionalProperties": false,
+								"properties": {
+									"field": { "type": "string", "minLength": 1 },
+									"dir": { "type": "string", "enum": ["asc", "desc"], "default": "asc" }
+								}
+							}
+						}
+					}
+				},
+				"toggle": {
+					"type": "object",
+					"required": ["key", "removes"],
+					"additionalProperties": false,
+					"description": "The workspace key a switch writes. While it is on (true, 1, \"1\", \"true\") the filter keys in `removes` are dropped, so a list that hides finished work shows it.",
+					"properties": {
+						"key": { "type": "string", "minLength": 1 },
+						"removes": { "type": "array", "minItems": 1, "items": { "type": "string", "minLength": 1 } }
+					}
 				}
 			}
 		},
@@ -4072,6 +4193,36 @@
 							"minLength": 1,
 							"description": "type='index', board look: free text after the footer's count, e.g. \"click a column header to sort\" (screens-index-list-parity). Maps to CnIndexPage `footerNote`."
 						},
+						"queryPresets": {
+							"type": "array",
+							"minItems": 1,
+							"description": "type='index': per-query overlays of this page (screens-index-query-presets). A menu entry that deep-links here with a query (`menu[].query`, e.g. { caseType: '<uuid>' }, the shape hydra gate-68 asks for instead of a second page) gets its own lenses, columns and copy: the first preset whose every `match` pair is in the route query replaces those keys of this config. Only the listed keys can be replaced; register, schema and permissions stay the page's. Switching preset remounts the list.",
+							"items": {
+								"type": "object",
+								"required": ["match"],
+								"additionalProperties": false,
+								"properties": {
+									"id": { "type": "string", "minLength": 1, "description": "A name for the preset, for people reading the manifest." },
+									"match": { "type": "object", "minProperties": 1, "additionalProperties": { "type": ["string", "number", "boolean"] }, "description": "Route query pairs that must ALL be present, e.g. { \"caseType\": \"<uuid>\" }. A repeated parameter matches when it holds the value." },
+									"title": { "type": "string", "minLength": 1, "description": "The page title while the preset applies." },
+									"quickFilters": { "type": "array", "description": "The lenses while the preset applies; same shape as config.quickFilters." },
+									"columns": { "type": "array", "description": "The columns while the preset applies; same shape as config.columns." },
+									"cardFields": { "type": "array", "items": { "type": "string" }, "description": "The card facts while the preset applies." },
+									"countText": { "type": "string", "minLength": 1, "description": "The count line while the preset applies." },
+									"searchPlaceholder": { "type": "string", "minLength": 1, "description": "The search placeholder while the preset applies." },
+									"footerNote": { "type": "string", "minLength": 1, "description": "The footer note while the preset applies." },
+									"defaultSort": { "type": "array", "description": "The default sort while the preset applies; same shape as config.defaultSort." },
+									"viewSwitch": { "type": "array", "items": { "type": "string", "enum": ["table", "cards", "board", "map"] }, "description": "The drawn view segments while the preset applies." }
+								}
+							}
+						},
+						"viewSwitch": {
+							"type": "array",
+							"minItems": 1,
+							"uniqueItems": true,
+							"items": { "type": "string", "enum": ["table", "cards", "board", "map"] },
+							"description": "type='index', board look: the segments the view switch draws, e.g. [\"table\", \"cards\", \"board\", \"map\"] as the boards do. A listed mode the page can open is an ordinary segment; one it cannot (no board columns, no map) is drawn disabled and named \"<mode>: not available on this list\". Order is always table, cards, board, map. Ignored without the board look (screens-view-switch-parity). Maps to CnIndexPage `viewSwitch`."
+						},
 						"searchPlaceholder": {
 							"type": "string",
 							"minLength": 1,
@@ -4087,6 +4238,38 @@
 							"description": "type='index': the property keys the cards view shows as the facts list of each card, in order; defaults to the first four list columns under the board look (screens-card-parity). Maps to CnIndexPage `cardFields`.",
 							"items": { "type": "string", "minLength": 1 }
 						},
+						"statRow": {
+							"type": "array",
+							"default": [],
+							"description": "type='index': KPI tiles above the list, between the header and the toolbar, in an auto-fit row (each at least 200px). Each entry is a widget definition, usually `type: \"stat\"`; the type resolves through the app's widget registry, then the dashboard catalog (screens-index-stat-row). Maps to CnIndexPage `statRow`.",
+							"items": {
+								"type": "object",
+								"required": ["id", "type"],
+								"properties": {
+									"id": { "type": "string", "minLength": 1 },
+									"type": { "type": "string", "minLength": 1 },
+									"title": { "type": "string" },
+									"content": { "type": "object" },
+									"headerLink": { "type": "object" }
+								}
+							}
+						},
+						"sidePanel": {
+							"type": "array",
+							"default": [],
+							"description": "type='index': titled cards in a 300px column right of the toolbar and the list (above them below 1024px). Each entry is a widget definition with an optional `title` (i18n key) and `headerLink`; the type resolves as for `statRow` (screens-index-stat-row). Maps to CnIndexPage `sidePanel`.",
+							"items": {
+								"type": "object",
+								"required": ["id", "type"],
+								"properties": {
+									"id": { "type": "string", "minLength": 1 },
+									"type": { "type": "string", "minLength": 1 },
+									"title": { "type": "string" },
+									"content": { "type": "object" },
+									"headerLink": { "type": "object" }
+								}
+							}
+						},
 						"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; under the board look it reads \"Download\" by default), `actions-menu` (the page's header actions as one labelled menu button, absent when the page has none), `import`, `refresh`, or the id of a `headerActions` entry. Under the board look the buttons render in a fixed order whatever the manifest declares: export, actions-menu, other secondary buttons, the buildiq square, then the primary button. 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`.",

package/src/utils/contentHeaderLink.js

@@ -0,0 +1,48 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * contentHeaderLink — the text link a widget's content asks its card header
+ * to carry: `content.headerLink`, or the shorter `viewAllRoute` (with an
+ * optional `viewAllLabel`) that an inbox-style widget uses for its "View all".
+ *
+ * @module utils/contentHeaderLink
+ */
+
+/**
+ * The header link a widget's `content` declares, in the shape
+ * CnWidgetWrapper's `headerLink` takes, or null when it declares none.
+ * The label is left as written: the wrapper translates it.
+ *
+ * `viewAllRoute` is a route name, or a location `{ name, params?, query? }`.
+ *
+ * @param {object|null|undefined} content The widget's content.
+ * @return {{label: string, route?: string, params?: object, query?: object, href?: string}|null}
+ */
+export function contentHeaderLink(content) {
+	if (!content || typeof content !== 'object') {
+		return null
+	}
+	const declared = content.headerLink
+	if (declared && typeof declared === 'object' && typeof declared.label === 'string' && declared.label !== '') {
+		return declared
+	}
+	const view = content.viewAllRoute
+	const name = typeof view === 'string' ? view : (view && typeof view === 'object' ? view.name : '')
+	if (typeof name !== 'string' || name === '') {
+		return null
+	}
+	const link = {
+		label: typeof content.viewAllLabel === 'string' && content.viewAllLabel !== '' ? content.viewAllLabel : 'View all',
+		route: name,
+	}
+	if (view && typeof view === 'object') {
+		if (view.params && typeof view.params === 'object') {
+			link.params = view.params
+		}
+		if (view.query && typeof view.query === 'object') {
+			link.query = view.query
+		}
+	}
+	return link
+}

package/src/utils/detailActionModel.js

@@ -201,13 +201,29 @@ export function resolveNextStep(config, object, stageField = 'status') {
 /**
  * Resolve a header pill from the record.
  *
- * @param {{field?: string, colorMap?: object, labels?: object, variant?: string}|null} config The pill config.
+ * A pill with `field` reads it off the record; one without `field` and with
+ * `text` is a constant. A count pill (`countFrom`) is resolved by
+ * {@link resolveCountPill} once its count is known.
+ *
+ * @param {{field?: string, text?: string, colorMap?: object, labels?: object, variant?: string}|null} config The pill config.
  * @param {object|null} object The record.
  * @return {{label: string, colorKey: string, colorMap: object|null, variant: string}|null} What CnStatusBadge needs, or null when the field is empty.
  * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-header-pills
  */
 export function resolvePill(config, object) {
-	if (!config || typeof config !== 'object' || typeof config.field !== 'string' || config.field === '') {
+	if (!config || typeof config !== 'object') {
+		return null
+	}
+	// A constant pill (`text`): "Inwoner", "Klant" (screens-relation-pages).
+	if ((typeof config.field !== 'string' || config.field === '') && typeof config.text === 'string' && config.text !== '') {
+		return {
+			label: config.text,
+			colorKey: config.text,
+			colorMap: config.colorMap && typeof config.colorMap === 'object' ? config.colorMap : null,
+			variant: typeof config.variant === 'string' && config.variant !== '' ? config.variant : 'default',
+		}
+	}
+	if (typeof config.field !== 'string' || config.field === '') {
 		return null
 	}
 	const raw = stageOf(object, config.field)
@@ -260,3 +276,44 @@ export function resolveTabCount(tab, object) {
 	const number = Number(value)
 	return Number.isFinite(number) ? number : null
 }
+
+/**
+ * The list a count pill counts (`countFrom`), or null for any other pill.
+ *
+ * @param {object|null} config The pill config.
+ * @return {{register: string, schema: string, filter: object}|null} The list.
+ * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-header-pill-can-be-a-constant-or-a-count
+ */
+export function pillCountSource(config) {
+	const from = config && typeof config === 'object' && !config.field ? config.countFrom : null
+	if (!from || typeof from !== 'object' || typeof from.register !== 'string' || from.register === '' || typeof from.schema !== 'string' || from.schema === '') {
+		return null
+	}
+	const filter = from.filter && typeof from.filter === 'object' && !Array.isArray(from.filter) ? from.filter : {}
+	return { register: from.register, schema: from.schema, filter }
+}
+
+/**
+ * A count pill once its count is known: "1 lopende zaak", "2 lopende zaken".
+ * Nothing for a count of 0, an unknown count or a failed one.
+ *
+ * @param {{countLabel?: {one?: string, other?: string}, colorMap?: object, variant?: string}|null} config The pill config.
+ * @param {number|null|undefined} count The count.
+ * @param {(text: string) => string} [translate] Applied to the label before `{count}` is filled.
+ * @return {{label: string, colorKey: string, colorMap: object|null, variant: string}|null} What CnStatusBadge needs, or null.
+ * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-header-pill-can-be-a-constant-or-a-count
+ */
+export function resolveCountPill(config, count, translate = (text) => text) {
+	if (!pillCountSource(config) || typeof count !== 'number' || !Number.isFinite(count) || count <= 0) {
+		return null
+	}
+	const labels = config.countLabel && typeof config.countLabel === 'object' ? config.countLabel : {}
+	const template = (count === 1 ? labels.one : labels.other) || labels.other || labels.one || '{count}'
+	const label = translate(template).replace(/\{count\}/g, String(count))
+	return {
+		label,
+		colorKey: '',
+		colorMap: config.colorMap && typeof config.colorMap === 'object' ? config.colorMap : null,
+		variant: typeof config.variant === 'string' && config.variant !== '' ? config.variant : 'default',
+	}
+}