@conduction/nextcloud-vue 2.111.0 → 2.113.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.133.0",
+	"version": "2.135.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -1212,6 +1212,7 @@
 							]
 						},
 						"pill": { "type": "string", "description": "The field shown as a status pill." },
+						"resolve": { "type": "object", "additionalProperties": false, "description": "pill-color-field: the `pill` field holds the id of a record; the pill takes the tone that record's colour maps onto and shows its icon. Register and schema default to the field's reference.", "properties": { "register": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "colorField": { "type": "string", "minLength": 1 }, "iconField": { "type": "string", "minLength": 1 } } },
 						"pillColors": {
 							"type": "object",
 							"description": "Pill value to badge variant. A value without an entry takes the default variant.",
@@ -1378,7 +1379,7 @@
 						"filter": { "type": "object", "additionalProperties": true }
 					}
 				},
-				"resolve": { "type": "object", "additionalProperties": false, "required": ["register", "schema"], "description": "detail-pill-resolve: the field holds the id of a record of this register and schema; the pill shows that record's `labelField` (else its title or name) and keys `colorMap` by it. The raw value shows while the lookup runs and when it finds nothing.", "properties": { "register": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "labelField": { "type": "string", "minLength": 1 } } },
+				"resolve": { "type": "object", "additionalProperties": false, "required": ["register", "schema"], "description": "detail-pill-resolve: the field holds the id of a record of this register and schema; the pill shows that record's `labelField` (else its title or name) and keys `colorMap` by it. The raw value shows while the lookup runs and when it finds nothing.", "properties": { "register": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "labelField": { "type": "string", "minLength": 1 }, "colorField": { "type": "string", "minLength": 1, "description": "pill-color-field: the referenced record's property holding a colour name (an NL Design System hue such as `red` or `blue-light`, or a badge role); the pill takes the tone it maps onto." }, "iconField": { "type": "string", "minLength": 1, "description": "pill-color-field: the referenced record's property holding a registered icon name, shown before the label." } } },
 				"countLabel": {
 					"type": "object",
 					"additionalProperties": false,
@@ -3103,10 +3104,17 @@
 			}
 		},
 		"action": {
+			"description": "A page action: the fields of $defs/actionFields, nothing else, with children that are actions too. Row, bulk and navigation actions use it; header actions use $defs/headerAction.",
+			"$ref": "#/$defs/actionFields",
+			"properties": {
+				"children": { "items": { "$ref": "#/$defs/action" } }
+			},
+			"unevaluatedProperties": false
+		},
+		"actionFields": {
 			"type": "object",
 			"required": ["id", "label"],
-			"additionalProperties": false,
-			"description": "A typed page action with a discriminator field. The type field determines behaviour: handler (registry function), open-modal (modal by id), open-page (named route), navigate (URL), object-op (declarative OpenRegister mutation via useObjectStore), export (opens the shared CnMassExportDialog export launcher), open-form (schema-driven create dialog — CnActionButtons), refresh (bumps the cn:page:refresh signal), api-call (POST/PUT an app endpoint + toast + refresh — CnActionButtons/dispatchAction), agent (run a governed hermiq agent), run-node (invoke one OpenRegister flow node against the page object, config collected via a dialog sourced from the node's own declared form — CnActionButtons/dispatchAction, or-flow-run-node; distinct from the UNRELATED setup-wizard step type of a similar name, 'run-action'), toggle (two-way state button — CnActionButtons only, NOT dispatchable). When type is omitted, it defaults to 'handler' (back-compatibility with v1.3.0 action declarations). The Ajv instance is compiled with useDefaults: true so the default is applied during validation.",
+			"description": "The fields of an action, shared by $defs/action and the non-link $defs/headerAction, which close it and constrain `children`. A typed page action with a discriminator field. The type field determines behaviour: handler (registry function), open-modal (modal by id), open-page (named route), navigate (URL), object-op (declarative OpenRegister mutation via useObjectStore), export (opens the shared CnMassExportDialog export launcher), open-form (schema-driven create dialog — CnActionButtons), refresh (bumps the cn:page:refresh signal), api-call (POST/PUT an app endpoint + toast + refresh — CnActionButtons/dispatchAction), agent (run a governed hermiq agent), run-node (invoke one OpenRegister flow node against the page object, config collected via a dialog sourced from the node's own declared form — CnActionButtons/dispatchAction, or-flow-run-node; distinct from the UNRELATED setup-wizard step type of a similar name, 'run-action'), toggle (two-way state button — CnActionButtons only, NOT dispatchable). When type is omitted, it defaults to 'handler' (back-compatibility with v1.3.0 action declarations). The Ajv instance is compiled with useDefaults: true so the default is applied during validation.",
 			"properties": {
 				"id": {
 					"type": "string",
@@ -3364,8 +3372,7 @@
 				},
 				"children": {
 					"type": "array",
-					"description": "Sub-actions, rendered by CnActionButtons as this action's OWN chevron dropdown beside its button — deliberately not folded into the page's single overflow menu, because NcActions cannot nest and a list that grows per record (app versions, say) would swamp it. Children take the same shape as any action, `visibleWhen` included, and an action carrying them consumes none of the `inline` slots. The parent itself still renders its own button beside the chevron (`type` defaults to 'handler' when omitted), so a parent meant only to group its children needs a `handler` that does something meaningful — an untyped, handler-less parent renders a button that dispatches to nothing.",
-					"items": { "$ref": "#/$defs/action" }
+					"description": "Sub-actions, rendered by CnActionButtons as this action's OWN chevron dropdown beside its button — deliberately not folded into the page's single overflow menu, because NcActions cannot nest and a list that grows per record (app versions, say) would swamp it. Children take the same shape as any action, `visibleWhen` included, and an action carrying them consumes none of the `inline` slots. The parent itself still renders its own button beside the chevron (`type` defaults to 'handler' when omitted), so a parent meant only to group its children needs a `handler` that does something meaningful — an untyped, handler-less parent renders a button that dispatches to nothing. Each child is an action; a header action's child is a header action, so it may be a link with `href`."
 				},
 				"childrenLabel": {
 					"type": "string",
@@ -3437,6 +3444,42 @@
 				}
 			]
 		},
+		"headerAction": {
+			"description": "A page header action (`headerActions[]`, a detail page's `quickActions[]` / `primaryActionByStage` entry, and their `children[]`): an action ($ref action), or with `href` a link ($ref headerLinkAction). Only header actions take `href`; row, bulk and navigation actions do not (2.135.0).",
+			"if": { "type": "object", "required": ["href"] },
+			"then": { "$ref": "#/$defs/headerLinkAction" },
+			"else": {
+				"$ref": "#/$defs/actionFields",
+				"properties": {
+					"children": { "items": { "$ref": "#/$defs/headerAction" } }
+				},
+				"unevaluatedProperties": false
+			}
+		},
+		"headerLinkAction": {
+			"type": "object",
+			"required": ["id", "label", "href"],
+			"additionalProperties": false,
+			"description": "A header action that is a real link (`<a href>`), so it can be middle-clicked, opened in a new tab, copied and bookmarked. It only navigates: it runs no handler and emits no `header-action`, so it carries no `handler` and no other `type` (2.135.0).",
+			"properties": {
+				"id": { "type": "string", "description": "Unique action identifier within the page's actions array." },
+				"label": { "type": "string", "description": "i18n key resolved by the consuming app's t() function at render time." },
+				"href": {
+					"type": "string",
+					"pattern": "^(https?://|mailto:|tel:|/)",
+					"description": "The link. An absolute `http(s)`, `mailto:` or `tel:` URL and a protocol-relative `//host/...` URL are used as written. A path starting with a Nextcloud entry point (`/index.php/`, `/remote.php/`, `/public.php/`, `/ocs/`) is prefixed with the instance root unless it already starts with it; any other instance path (leading `/`, e.g. `/apps/integriq/connections`) goes through `generateUrl()`."
+				},
+				"target": { "type": "string", "enum": ["_blank", "_self"], "default": "_self", "description": "`_blank` opens the link in a new tab; `_self` opens it in place." },
+				"type": { "const": "handler", "description": "Only the default; a link has no other behaviour." },
+				"icon": { "type": "string", "description": "Optional icon: an MDI icon name or a CSS icon class, as on any action." },
+				"variant": { "type": "string", "description": "CnActionButtons button variant, as on any action." },
+				"group": { "type": "string", "minLength": 1, "description": "Detail page header actions only: the overflow menu group, as on any action." },
+				"adminOnly": { "type": "boolean", "default": false, "description": "Detail page header actions only: show the link to instance admins alone, as on any action." },
+				"visibleWhen": { "$ref": "#/$defs/visibleWhen", "description": "An optional predicate gating whether the link renders, as on any action." },
+				"children": { "type": "array", "description": "Sub-actions in the link's own chevron dropdown, as on any action.", "items": { "$ref": "#/$defs/headerAction" } },
+				"childrenLabel": { "type": "string", "description": "Name of the sub-action chevron, as on any action." }
+			}
+		},
 		"fieldValidation": {
 			"type": "object",
 			"additionalProperties": false,
@@ -4353,7 +4396,7 @@
 							"additionalProperties": {
 								"oneOf": [
 									{ "type": "string", "minLength": 1 },
-									{ "$ref": "#/$defs/action" }
+									{ "$ref": "#/$defs/headerAction" }
 								]
 							}
 						},
@@ -4364,7 +4407,7 @@
 							"items": {
 								"oneOf": [
 									{ "type": "string", "minLength": 1 },
-									{ "$ref": "#/$defs/action" }
+									{ "$ref": "#/$defs/headerAction" }
 								]
 							}
 						},
@@ -4488,8 +4531,8 @@
 						},
 						"headerActions": {
 							"type": "array",
-							"description": "Page-level header actions rendered inside CnActionsBar's overflow dropdown (between the built-in Refresh action and the `#action-items` slot). On a `type:'detail'` page the same entries render in the header's Actions menu, above the Request-a-feature / Report-a-bug / Documentation trio. Same shape as the row-level `actions[]` ($ref action), but handlers receive NO row context — they are page-level. Reserved ids (`refresh`, `import`, `export`, `copy`, `delete`) are dropped at render time to avoid shadowing built-ins. See manifest-icons-and-page-actions for the dispatch semantics.",
-							"items": { "$ref": "#/$defs/action" }
+							"description": "Page-level header actions rendered inside CnActionsBar's overflow dropdown (between the built-in Refresh action and the `#action-items` slot). On a `type:'detail'` page the same entries render in the header's Actions menu, above the Request-a-feature / Report-a-bug / Documentation trio. Same shape as the row-level `actions[]` ($ref action), but handlers receive NO row context — they are page-level. Reserved ids (`refresh`, `import`, `export`, `copy`, `delete`) are dropped at render time to avoid shadowing built-ins. An entry with `href` (instead of `handler`) renders as a real link to that URL and is never dispatched ($ref headerAction). See manifest-icons-and-page-actions for the dispatch semantics.",
+							"items": { "$ref": "#/$defs/headerAction" }
 						},
 						"bulkActions": {
 							"type": "array",
@@ -4694,6 +4737,11 @@
 										"type": "string",
 										"description": "One label for the control's label filter."
 									},
+									"icon": {
+										"type": "string",
+										"minLength": 1,
+										"description": "pill-color-field: a registered icon name the view's My views menu entry shows instead of the filter icon (a case type's own icon, say)."
+									},
 									"overrides": {
 										"type": "object",
 										"additionalProperties": false,
@@ -5339,14 +5387,14 @@
 							"additionalProperties": false,
 							"description": "type='index', board look: the record layout of each card in the cards view (board-record-card-layout): a pill and the number on the head row, the title, a meta line, and a footer with a pill and a date. Each part names a field (a dot path) and is left out while it is empty; a pill maps values to a badge variant (`colorMap`, ignoring case) and to shown text (`labels`). Maps to CnIndexPage `cardLayout`.",
 							"properties": {
-								"headPill": { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "colorMap": { "type": "object", "additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "variant": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] }, "due": { "type": "object", "description": "Read the field as a due date: overdue gives the error variant, within `soonWithin` days the warning one; any other date draws no pill.", "properties": { "soonWithin": { "type": "number", "minimum": 0 } } }, "variantWhen": { "type": "array", "description": "Rules on the days left until the field's date, `{ op, value, variant }`; the first match gives the variant, no match draws no pill.", "items": { "type": "object", "required": ["op", "value", "variant"], "properties": { "op": { "type": "string" }, "value": { "type": "number" }, "variant": { "type": "string" } } } } } },
+								"headPill": { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "resolve": { "type": "object", "additionalProperties": false, "description": "pill-color-field: the field holds the id of a record; the pill takes the tone that record's colour maps onto and shows its icon. Register and schema default to the field's reference.", "properties": { "register": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "colorField": { "type": "string", "minLength": 1 }, "iconField": { "type": "string", "minLength": 1 } } }, "colorMap": { "type": "object", "additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "variant": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] }, "due": { "type": "object", "description": "Read the field as a due date: overdue gives the error variant, within `soonWithin` days the warning one; any other date draws no pill.", "properties": { "soonWithin": { "type": "number", "minimum": 0 } } }, "variantWhen": { "type": "array", "description": "Rules on the days left until the field's date, `{ op, value, variant }`; the first match gives the variant, no match draws no pill.", "items": { "type": "object", "required": ["op", "value", "variant"], "properties": { "op": { "type": "string" }, "value": { "type": "number" }, "variant": { "type": "string" } } } } } },
 								"number": { "type": "string", "minLength": 1 },
 								"title": { "type": "string", "minLength": 1 },
 								"meta": { "type": "array", "description": "The meta line's parts: a field name reads through the page column it names; `{ field, formatter?, formatterOptions? }` reads as plain text through its own formatter (card-layout-part-formatter).", "items": { "oneOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "formatter": { "type": "string", "minLength": 1 }, "formatterOptions": { "type": "object" } } } ] } },
-								"footerPill": { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "colorMap": { "type": "object", "additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "variant": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] }, "due": { "type": "object", "description": "Read the field as a due date: overdue gives the error variant, within `soonWithin` days the warning one; any other date draws no pill.", "properties": { "soonWithin": { "type": "number", "minimum": 0 } } }, "variantWhen": { "type": "array", "description": "Rules on the days left until the field's date, `{ op, value, variant }`; the first match gives the variant, no match draws no pill.", "items": { "type": "object", "required": ["op", "value", "variant"], "properties": { "op": { "type": "string" }, "value": { "type": "number" }, "variant": { "type": "string" } } } } } },
+								"footerPill": { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "resolve": { "type": "object", "additionalProperties": false, "description": "pill-color-field: the field holds the id of a record; the pill takes the tone that record's colour maps onto and shows its icon. Register and schema default to the field's reference.", "properties": { "register": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "colorField": { "type": "string", "minLength": 1 }, "iconField": { "type": "string", "minLength": 1 } } }, "colorMap": { "type": "object", "additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "variant": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] }, "due": { "type": "object", "description": "Read the field as a due date: overdue gives the error variant, within `soonWithin` days the warning one; any other date draws no pill.", "properties": { "soonWithin": { "type": "number", "minimum": 0 } } }, "variantWhen": { "type": "array", "description": "Rules on the days left until the field's date, `{ op, value, variant }`; the first match gives the variant, no match draws no pill.", "items": { "type": "object", "required": ["op", "value", "variant"], "properties": { "op": { "type": "string" }, "value": { "type": "number" }, "variant": { "type": "string" } } } } } },
 								"footerDate": { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "label": { "type": "string", "minLength": 1 }, "overdueVariant": { "type": "string", "enum": ["error", "warning"], "description": "The date's tone once it has passed (2.132.0)." } } },
 								"description": { "description": "A line under the meta line: a field, or `{ field, maxLength? }` cut at maxLength characters (140 by default) with an ellipsis (2.132.0).", "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "maxLength": { "type": "integer", "minimum": 1 } } }] },
-								"chips": { "type": "array", "description": "Pills under the description, one per entry whose field holds a value; the text reads through the entry's formatter, `colorMap` and `labels` work as on a pill (2.132.0).", "items": { "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "formatter": { "type": "string", "minLength": 1 }, "formatterOptions": { "type": "object" }, "colorMap": { "type": "object", "additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "variant": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } } }] } }
+								"chips": { "type": "array", "description": "Pills under the description, one per entry whose field holds a value; the text reads through the entry's formatter, `colorMap` and `labels` work as on a pill (2.132.0).", "items": { "anyOf": [{ "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": false, "required": ["field"], "properties": { "field": { "type": "string", "minLength": 1 }, "resolve": { "type": "object", "additionalProperties": false, "description": "pill-color-field: the field holds the id of a record; the pill takes the tone that record's colour maps onto and shows its icon. Register and schema default to the field's reference.", "properties": { "register": { "type": "string", "minLength": 1 }, "schema": { "type": "string", "minLength": 1 }, "colorField": { "type": "string", "minLength": 1 }, "iconField": { "type": "string", "minLength": 1 } } }, "formatter": { "type": "string", "minLength": 1 }, "formatterOptions": { "type": "object" }, "colorMap": { "type": "object", "additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } }, "labels": { "type": "object", "additionalProperties": { "type": "string" } }, "variant": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] } } }] } }
 							}
 						},
 						"afterList": { "type": "array", "description": "type='index': cards after the list, stacked full width in the listed order, the counterpart of statRow above it (index-scope-presentation). Each entry is a widget definition resolved like statRow's. A query preset or a folder scope can set its own. Maps to CnIndexPage `afterList`.", "items": { "type": "object", "required": ["id", "type"], "properties": { "id": { "type": "string", "minLength": 1 }, "type": { "type": "string", "minLength": 1 }, "title": { "type": "string" }, "subtitle": { "type": "string" }, "content": { "type": "object" }, "headerLink": { "type": "object" } } } },

package/src/store/plugins/liveUpdates.js

@@ -399,6 +399,8 @@ export function liveUpdatesPlugin(opts = {}) {
 			// Plain (non-reactive) Map: type → last params object
 			store.__lastCollectionParams = new Map()
 
+			// Detached: the store outlives the component whose setup first
+			// used it, and an attached observer is removed with that scope.
 			store.$onAction(({ name, args, after }) => {
 				if (name === 'fetchCollection') {
 					const [type, params = {}] = args
@@ -406,7 +408,7 @@ export function liveUpdatesPlugin(opts = {}) {
 						store.__lastCollectionParams.set(type, params)
 					})
 				}
-			})
+			}, true)
 
 			// -- In-flight dedup for fetchObject --
 			// Plain Map: dedupKey → Promise

package/src/store/plugins/logs.js

@@ -156,6 +156,7 @@ export function logsPlugin(options = {}) {
 
 	if (autoRefreshOnItemChange) {
 		plugin.setup = function setup(store) {
+			// Detached: the store outlives the component whose setup first used it.
 			store.$onAction(({ name, after }) => {
 				if (name !== 'setItem') {
 					return
@@ -170,7 +171,7 @@ export function logsPlugin(options = {}) {
 						store.clearLogs()
 					}
 				})
-			})
+			}, true)
 		}
 	}
 

package/src/utils/actionLink.js

@@ -9,11 +9,114 @@
  * The rendering component turns it into an `<a href>`; a plain click on an
  * in-app `to` is routed through the router, anything else is the browser's.
  *
+ * A manifest `headerActions[]` entry may carry `href` too; the page turns it
+ * into the final URL with {@link headerActionAsLink} before it renders.
+ *
  * @module utils/actionLink
  */
 
+import { generateUrl, getRootUrl } from '@nextcloud/router'
 import { followLinkClick } from './linkNavigation.js'
 
+/** An absolute URL a manifest link may name, matching the schema's lowercase pattern. */
+const ABSOLUTE_HREF = /^(?:https?:\/\/|mailto:|tel:)/
+
+/** An instance path that already names a Nextcloud entry point, so generateUrl() must not add `/index.php`. */
+const ROUTED_PATH = /^\/(?:index\.php|remote\.php|public\.php|ocs)(?:[/?#]|$)/
+
+/** Bad hrefs already warned about, so a recomputing page warns once per value. */
+const warnedHrefs = new Set()
+
+/**
+ * Entries whose function handler was dropped for their href, warned about
+ * once. Keyed by `id`, else by the declared href and label (behind a NUL, so
+ * no real id collides), so entries without an id each get their own warning
+ * and a recomputing page does not repeat it.
+ */
+const warnedHandlers = new Set()
+
+/**
+ * The URL a manifest `href` points at: an absolute `http(s)`, `mailto:` or
+ * `tel:` URL as written, `//host/...` as written, an instance path that
+ * names an entry point (`/index.php/`, `/remote.php/`, `/public.php/`,
+ * `/ocs/`) under `getRootUrl()` (as written when it already starts with the
+ * root), any other instance path (leading `/`) through `generateUrl()`.
+ *
+ * @spec openspec/changes/header-action-href/specs/header-action-href/spec.md#requirement-a-header-action-href-resolves-to-a-url-on-this-instance-or-an-allowed-scheme
+ * @param {unknown} href The manifest `href`.
+ * @return {string} The URL, or '' for anything else (a relative path, another scheme).
+ */
+export function resolveManifestHref(href) {
+	if (typeof href !== 'string') {
+		return ''
+	}
+	const value = href.trim()
+	if (ABSOLUTE_HREF.test(value) || value.startsWith('//')) {
+		return value
+	}
+	const root = getRootUrl()
+	if (root && value.startsWith(root) && ROUTED_PATH.test(value.slice(root.length))) {
+		return value
+	}
+	if (ROUTED_PATH.test(value)) {
+		return root + value
+	}
+	if (value.startsWith('/')) {
+		return generateUrl(value)
+	}
+	return ''
+}
+
+/**
+ * A manifest header action in its link form. An entry with `href` gets the
+ * resolved URL and an anchor `target` (`_blank` when the manifest says so,
+ * else `_self`), and loses its `handler`: a link only navigates. Its
+ * `children` are resolved the same way. An `href` that resolves to nothing is
+ * dropped with a warning, along with a handler name, so the page renders its
+ * usual button for the entry (an index or reports page still emits
+ * `header-action` for it); a function `handler` (JS composition) is kept
+ * then and still runs. An entry with nothing to resolve, a function-valued
+ * `href` included, is returned as is. When the `href` does resolve, a
+ * function `handler` is dropped like any other, with a one-time warning.
+ *
+ * @spec openspec/changes/header-action-href/specs/header-action-href/spec.md#requirement-a-header-action-with-href-is-a-link-that-runs-and-emits-nothing
+ * @param {object} entry The manifest header action.
+ * @return {object} The entry, or a copy in link form.
+ */
+export function headerActionAsLink(entry) {
+	if (!entry || typeof entry !== 'object') {
+		return entry
+	}
+	let resolved = entry
+	if (Array.isArray(entry.children)) {
+		const children = entry.children.map(headerActionAsLink)
+		if (children.some((child, index) => child !== entry.children[index])) {
+			resolved = { ...entry, children }
+		}
+	}
+	if (typeof entry.href !== 'string' || entry.href === '') {
+		return resolved
+	}
+	const { href: declared, ...withoutHref } = resolved
+	const { handler: _handler, ...rest } = withoutHref
+	const href = resolveManifestHref(declared)
+	if (!href) {
+		if (!warnedHrefs.has(declared)) {
+			warnedHrefs.add(declared)
+			// eslint-disable-next-line no-console
+			console.warn(`headerActions[].id "${entry.id}": href "${declared}" is neither an http(s), mailto or tel URL nor an instance path starting with "/"; the entry renders without a link`)
+		}
+		return typeof entry.handler === 'function' ? withoutHref : rest
+	}
+	const handlerKey = entry.id ?? `\u0000${declared}|${entry.label ?? ''}`
+	if (typeof entry.handler === 'function' && !warnedHandlers.has(handlerKey)) {
+		warnedHandlers.add(handlerKey)
+		// eslint-disable-next-line no-console
+		console.warn(`headerActions[].id "${entry.id}": an entry with href never runs a handler, so its function handler is dropped`)
+	}
+	return { ...rest, href, target: entry.target === '_blank' ? '_blank' : '_self' }
+}
+
 /**
  * The href of an in-app router location. A string is a route PATH and goes
  * through the router as well, so a hash-history app gets its `#`.

package/src/utils/detailActionModel.js

@@ -16,6 +16,7 @@
  * @module utils/detailActionModel
  */
 
+import { variantForColor } from './headerFieldChips.js'
 import { readPath } from './readPath.js'
 import { evaluateVisibleWhenLocal } from './visibleWhen.js'
 
@@ -239,6 +240,32 @@ export function resolvePill(config, object) {
 	}
 }
 
+/**
+ * What a pill takes from the record its `resolve` points at
+ * (`resolve.colorField`, `resolve.iconField`): the tone its colour name maps
+ * onto (an NL Design System hue or a badge role, see `variantForColor`), which
+ * replaces the pill's own `variant` and `colorMap`, and an icon name. An empty
+ * colour or icon leaves the pill as declared.
+ *
+ * @param {{color?: string|null, icon?: string|null}|null|undefined} look The names read off the record.
+ * @return {{variant?: string, colorMap?: null, icon?: string}} The keys to lay over the pill.
+ * @spec openspec/changes/pill-color-field/specs/pill-color-field/spec.md#requirement-a-pill-takes-its-tone-and-icon-from-the-referenced-record
+ */
+export function pillLook(look) {
+	const out = {}
+	if (!look || typeof look !== 'object') {
+		return out
+	}
+	if (typeof look.color === 'string' && look.color !== '') {
+		out.variant = variantForColor(look.color)
+		out.colorMap = null
+	}
+	if (typeof look.icon === 'string' && look.icon !== '') {
+		out.icon = look.icon
+	}
+	return out
+}
+
 /**
  * Resolve a tab's count.
  *

package/src/utils/fillTemplate.js

@@ -7,7 +7,7 @@ import { formatMoney } from './formatMetric.js'
 import { readPath } from './readPath.js'
 import { userDisplayName } from './userDisplayName.js'
 
-const TOKEN = /\{([^{}\s|]+)(?:\|([a-z]+)(?::([^{}\s]+))?)?\}/g
+const TOKEN = /\{([^{}\s|]+)(?:\|([A-Za-z]+)(?::([^{}\s]+))?)?\}/g
 
 /**
  * A moment in the board's short form with the time: "4 okt, 10:52", or
@@ -68,12 +68,18 @@ export function formatLongDate(value, now = new Date(), withYear = false) {
  * @param {string} [arg] The format's argument (`currency:EUR`, or a row path holding the code).
  * @param {object|null} [object] The row, for a currency read from a field.
  * @param {object|null} [config] The app config map, for the reporting currency.
+ * @param {object|null} [formatters] The app's named formatters (`cnFormatters`), for any other format name.
  * @return {string} The text, '' when nothing can be shown.
+ * @spec openspec/changes/map-list-formatters/specs/map-list-formatters/spec.md#requirement-a-map-list-reads-display-names-through-the-apps-formatters
  */
-function formatValue(value, format, now, arg = '', object = null, config = null) {
+function formatValue(value, format, now, arg = '', object = null, config = null, formatters = null) {
 	if (value === null || value === undefined || value === '' || typeof value === 'object') {
 		return ''
 	}
+	if (format !== '' && formatters && typeof formatters[format] === 'function') {
+		const shown = formatters[format](value, object)
+		return shown === null || shown === undefined ? '' : String(shown)
+	}
 	if (format === 'date') {
 		return formatBoardDate(value, now)
 	}
@@ -130,14 +136,16 @@ function formatValue(value, format, now, arg = '', object = null, config = null)
  * the row field is empty, the app's reporting currency), `{path|relative}` and
  * `{path|relativetime}` say "today", "yesterday" and then the short date
  * ("vandaag, 09.42"), and `{path|days}` is the
- * whole days since that date ("has waited {createdAt|days} days"). A token without a
+ * whole days since that date ("has waited {createdAt|days} days"). Any other
+ * name is one of the app's formatters, passed as `context.formatters`
+ * (`{id|caseAddress}`). A token without a
  * value empties the WHOLE template, because "Termijn " is worse than nothing.
  * A template without tokens is returned as written (a constant label).
  *
  * @param {string} template The template, already translated.
  * @param {object|null} object The object to read.
  * @param {Date} [now] The reference moment for dates.
- * @param {{config?: object}|null} [context] The app config map, for the reporting currency of a money token.
+ * @param {{config?: object, formatters?: object}|null} [context] The app config map, for the reporting currency of a money token, and the app's named formatters.
  * @return {string} The filled text, or ''.
  * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record
  */
@@ -148,7 +156,7 @@ export function fillTemplate(template, object, now = new Date(), context = null)
 	let missing = false
 	const text = template.replace(TOKEN, (_match, path, format, arg) => {
 		const value = object && typeof object === 'object' ? readPath(object, path) : undefined
-		const shown = formatValue(value, format || '', now, arg || '', object, context && context.config ? context.config : null)
+		const shown = formatValue(value, format || '', now, arg || '', object, context && context.config ? context.config : null, context && context.formatters ? context.formatters : null)
 		if (shown === '') {
 			missing = true
 		}

package/src/utils/headerFieldChips.js

@@ -11,7 +11,12 @@
 /** The renderers a header chip can use. */
 export const HEADER_CHIP_FORMATS = Object.freeze(['text', 'mono', 'badge', 'user', 'date'])
 
-/** The variants a colour name maps onto; anything else is neutral. */
+/**
+ * The variants a colour name maps onto; anything else is neutral. A name is a
+ * badge role (`success`, `warning`, ...) or an NL Design System hue as a
+ * register stores it (`red`, `blue-light`, ...): a hue and its light tint
+ * take the same tone.
+ */
 const COLOR_VARIANTS = Object.freeze({
 	success: 'success',
 	warning: 'warning',
@@ -19,6 +24,20 @@ const COLOR_VARIANTS = Object.freeze({
 	info: 'info',
 	primary: 'primary',
 	neutral: 'default',
+	blue: 'info',
+	'blue-light': 'info',
+	green: 'success',
+	'green-light': 'success',
+	orange: 'warning',
+	'orange-light': 'warning',
+	red: 'error',
+	'red-light': 'error',
+	purple: 'purple',
+	'purple-light': 'purple',
+	teal: 'teal',
+	'teal-light': 'teal',
+	grey: 'default',
+	'grey-light': 'default',
 })
 
 /**
@@ -69,7 +88,7 @@ export function isEmptyChipValue(value) {
 /**
  * Map a colour name read off a referenced object onto a badge variant.
  *
- * @param {*} name The colour name (`success`, `warning`, `error`, `info`, `neutral`).
+ * @param {*} name The colour name: a badge role (`success`, `warning`, `error`, `info`, `neutral`) or an NL Design System hue (`red`, `blue-light`, ...).
  * @return {string} A `CnStatusBadge` variant; `default` (neutral) when unknown.
  */
 export function variantForColor(name) {

package/src/utils/mapList.js

@@ -3,7 +3,8 @@
  * SPDX-License-Identifier: EUPL-1.2
  */
 import { isBadgeVariant } from './badgeVariants.js'
-import { fillTemplate } from './fillTemplate.js'
+import { pillLook } from './detailActionModel.js'
+import { fillTemplate, firstFilled } from './fillTemplate.js'
 import { readPath } from './readPath.js'
 
 /**
@@ -12,10 +13,14 @@ import { readPath } from './readPath.js'
  * 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.
+ * formatter?, colorMap?, variant?, resolve? }], due? }`. `title`, `sub` and `due` are
+ * field templates (`"{title}"`, `"{address} · {identifier}"`,
+ * `"{deadline|date}"`), already translated by the caller; `sub` may list
+ * several, the first that fills wins. A pill reads `path` (or shows `text`),
+ * maps it through `map` or the app formatter `formatter` (a reference's
+ * display name), and takes its tone from `colorMap` by the raw value, or,
+ * with `resolve`, the tone and icon of the record the value points at
+ * (`options.looks`, read by CnIndexPage as for its other pills).
  *
  * @param {Array<object>} rows The rows, in display order.
  * @param {object} spec The list declaration.
@@ -23,9 +28,14 @@ import { readPath } from './readPath.js'
  * @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.
+ * @param {object} [options.formatters] The app's named formatters, for pills and template tokens.
+ * @param {object} [options.looks] The referenced records' looks by field and id (`{ [path]: { [id]: { color, icon } } }`).
  * @return {{items: Array<{key: string, n: number, row: object, title: string, sub: string, due: string, pills: Array<{label: string, variant: string}>}>, missing: Array<object>}}
+ * @spec openspec/changes/map-list-formatters/specs/map-list-formatters/spec.md#requirement-a-map-list-reads-display-names-through-the-apps-formatters
+ * @spec openspec/changes/map-list-formatters/specs/map-list-formatters/spec.md#requirement-a-map-list-pill-takes-its-tone-and-icon-from-the-referenced-record
  */
-export function mapListItems(rows, spec, { rowKey, located, translate = (text) => text }) {
+export function mapListItems(rows, spec, { rowKey, located, translate = (text) => text, formatters = null, looks = null }) {
+	const context = formatters ? { formatters } : null
 	const items = []
 	const missing = []
 	const list = spec && typeof spec === 'object' ? spec : {}
@@ -40,7 +50,9 @@ export function mapListItems(rows, spec, { rowKey, located, translate = (text) =
 					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 formatter = typeof pill.formatter === 'string' && formatters ? formatters[pill.formatter] : null
+				const formatted = typeof formatter === 'function' && (typeof raw === 'string' || typeof raw === 'number') && raw !== '' ? formatter(raw, row) : undefined
+				const mapped = pill.map && (typeof raw === 'string' || typeof raw === 'number') && Object.hasOwn(pill.map, raw) ? pill.map[raw] : formatted
 				const text = mapped ?? pill.text ?? raw
 				if (typeof text !== 'string' && typeof text !== 'number') {
 					return null
@@ -50,16 +62,19 @@ export function mapListItems(rows, spec, { rowKey, located, translate = (text) =
 					return null
 				}
 				const tone = pill.colorMap && (typeof raw === 'string' || typeof raw === 'number') ? pill.colorMap[raw] : pill.variant
-				return { label, variant: isBadgeVariant(tone) ? tone : 'default' }
+				const fieldLooks = pill.resolve && looks && typeof pill.path === 'string' ? looks[pill.path] : null
+				const look = pillLook(fieldLooks && (typeof raw === 'string' || typeof raw === 'number') ? fieldLooks[String(raw)] : null)
+				const variant = look.variant || tone
+				return { label, variant: isBadgeVariant(variant) ? variant : 'default', ...(look.icon ? { icon: look.icon } : {}) }
 			})
 			.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),
+			title: fillTemplate(list.title || '', row, undefined, context),
+			sub: list.sub ? firstFilled(list.sub, row, undefined, undefined, context) : '',
+			due: fillTemplate(list.due || '', row, undefined, context),
 			pills,
 		})
 	}

package/src/utils/savedViewMenu.js

@@ -64,6 +64,9 @@ export function normalizeSavedViewMenu(entries) {
 		}
 		seen.add(`${page}|${id}`)
 		const entry = { id, page, name: e && typeof e.name === 'string' && e.name !== '' ? e.name : id }
+		if (typeof e.icon === 'string' && e.icon !== '') {
+			entry.icon = e.icon
+		}
 		const badge = normalizeBadge(e.badge)
 		if (badge) {
 			entry.badge = badge
@@ -87,12 +90,12 @@ export function toggleSavedViewMenuEntry(entries, entry) {
 	if (present) {
 		return list.filter((e) => !(e.id === id && e.page === entry.page))
 	}
-	return normalizeSavedViewMenu([...list, { id, page: entry.page, name: entry.name, badge: entry.badge }])
+	return normalizeSavedViewMenu([...list, { id, page: entry.page, name: entry.name, icon: entry.icon, badge: entry.badge }])
 }
 
 /**
  * Bring one page's entries in line with the views that page can show:
- * current names and badges, and no entry for a view that was deleted or is
+ * current names, icons and badges, and no entry for a view that was deleted or is
  * no longer shared with the user. Other pages' entries are left alone. A
  * view's badge is read from its `menuBadge` (see `withSavedViewMenu`).
  *
@@ -110,9 +113,10 @@ export function syncSavedViewMenu(entries, page, views) {
 				return e
 			}
 			const view = byId.get(e.id)
-			const { badge, ...rest } = e
+			const { badge, icon, ...rest } = e
 			const next = normalizeBadge(view.menuBadge)
-			return normalizeSavedViewMenu([{ ...rest, name: view.name || e.name, ...(next ? { badge: next } : {}) }])[0]
+			const nextIcon = typeof view.icon === 'string' && view.icon !== '' ? view.icon : icon
+			return normalizeSavedViewMenu([{ ...rest, name: view.name || e.name, ...(nextIcon ? { icon: nextIcon } : {}), ...(next ? { badge: next } : {}) }])[0]
 		})
 }
 
@@ -127,6 +131,9 @@ export const SAVED_VIEW_MENU_EMPTY = 'saved-views-empty'
  * same place (Ruben's design rule, 19 Oct); it replaces app-specific groups
  * such as dossiq's "My case types".
  *
+ * An entry shows its view's `icon` (a registered icon name; a case type's
+ * own icon, say), else the filter icon.
+ *
  * An entry with a badge carries it as the menu entry's `count` (and
  * `counterVariant`), which CnAppRoot fetches like any filtered menu count.
  *
@@ -154,7 +161,7 @@ export function withSavedViewMenu(menu, entries, options = {}) {
 					label: e.name,
 					route: e.page,
 					query: { savedView: e.id },
-					icon: 'FilterOutline',
+					icon: e.icon || 'FilterOutline',
 					...(e.badge || {}),
 				}))
 			: [{ id: SAVED_VIEW_MENU_EMPTY, type: 'hint', label: t('nextcloud-vue', 'Add a view to the menu from Filters') }]),