@conduction/nextcloud-vue 2.110.0 → 2.112.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.134.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,
@@ -4694,6 +4695,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 +5345,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/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/savedViewHelpers.js

@@ -284,15 +284,18 @@ export function schemaSlug(schema) {
  * it: three case indexes share their views, the organisations index does
  * not. `savedViewsScope` on a page overrides that, for pages that should
  * share views although they read different sources, or keep them apart
- * although they read the same one.
+ * although they read the same one. A page over a named source
+ * (`entitySource`) and no schema shares its views with the pages over that
+ * source.
  *
  * @param {object} page The page.
  * @param {string} [page.scope] The explicit `savedViewsScope`, when set.
  * @param {string} [page.register] The page's register.
  * @param {object|string} [page.schema] The page's schema, slug or object.
+ * @param {string} [page.source] The page's `entitySource`, when it reads one.
  * @return {string} The scope key, or the empty string for a page with no source.
  */
-export function savedViewScope({ scope, register, schema } = {}) {
+export function savedViewScope({ scope, register, schema, source } = {}) {
 	if (typeof scope === 'string' && scope !== '') {
 		return scope
 	}
@@ -300,9 +303,43 @@ export function savedViewScope({ scope, register, schema } = {}) {
 	if (typeof register === 'string' && register !== '' && slug !== '') {
 		return `${register}/${slug}`
 	}
+	if (typeof source === 'string' && source !== '') {
+		return `source:${source}`
+	}
 	return ''
 }
 
+/**
+ * Whether an index page offers saved views in its sidebar.
+ *
+ * `allowSavedViews` decides when it is set. Unset, every index page that has
+ * a sidebar and a source a view can be scoped to (a register and schema, a
+ * named source, or `savedViewsScope`) offers them, so managing views is
+ * there on every list without each page opting in.
+ *
+ * @param {object} config The page's index config, or CnIndexPage's props.
+ * @param {boolean|null} [config.allowSavedViews] The explicit choice, when made.
+ * @param {object} [config.sidebar] The sidebar config.
+ * @param {string} [config.savedViewsScope] The explicit scope.
+ * @param {string} [config.register] The register.
+ * @param {object|string} [config.schema] The schema.
+ * @param {string} [config.entitySource] The named source.
+ * @return {boolean}
+ */
+export function pageOffersSavedViews(config) {
+	if (!config || typeof config !== 'object') {
+		return false
+	}
+	if (typeof config.allowSavedViews === 'boolean') {
+		return config.allowSavedViews
+	}
+	const sidebar = config.sidebar
+	if (!sidebar || typeof sidebar !== 'object' || sidebar.enabled !== true || sidebar.show === false) {
+		return false
+	}
+	return savedViewScope({ scope: config.savedViewsScope, register: config.register, schema: config.schema, source: config.entitySource }) !== ''
+}
+
 /**
  * Whether a saved view belongs on a page.
  *

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') }]),