@conduction/nextcloud-vue 2.111.0 → 2.113.0

package/src/components/CnIndexPage/CnIndexPage.vue

@@ -63,7 +63,7 @@
 									<NcActionLink
 										v-else-if="entry.href"
 										:href="entry.href"
-										target="_blank"
+										:target="entry.linkTarget || '_blank'"
 										rel="noopener noreferrer"
 										:data-testid="`cn-index-header-menu-${entry.key}`">
 										<template v-if="entry.icon" #icon>
@@ -103,6 +103,8 @@
 							<NcButton
 								v-else
 								:variant="button.variant"
+								:href="button.link ? button.link.href : undefined"
+								:target="button.link ? button.link.target : undefined"
 								:data-testid="`cn-index-header-button-${button.key}`"
 								@click="onHeaderButton(button)">
 								<template v-if="button.icon" #icon>
@@ -947,7 +949,11 @@
 										<CnStatusBadge v-for="(pill, index) in item.pills"
 											:key="index"
 											:label="pill.label"
-											:variant="pill.variant" />
+											:variant="pill.variant">
+											<template v-if="pill.icon" #icon>
+												<CnIcon :name="pill.icon" :size="14" />
+											</template>
+										</CnStatusBadge>
 										<span v-if="item.due" class="cn-index-page__map-due">{{ item.due }}</span>
 									</span>
 								</div>
@@ -995,6 +1001,7 @@
 					:swimlaneField="board.swimlaneField || ''"
 					:dueRule="board.dueRule || null"
 					:cardRoles="board.card || null"
+					:pillLooks="refLooks"
 					:colorField="board.colorField || ''"
 					:sumField="board.sumField || ''"
 					:sumFormat="boardSumFormat"
@@ -1047,7 +1054,7 @@
 					v-else-if="currentViewMode === 'list'"
 					:objects="displayObjects"
 					:schema="effectiveSchema"
-					:config="listConfig"
+					:config="renderedListConfig"
 					:selectable="selectable"
 					:selectedIds="internalSelectedIds"
 					:rowKey="rowKey"
@@ -1107,6 +1114,7 @@
 					:clickToView="rowClickOpens"
 					:cardFields="resolvedCardFields"
 					:cardLayout="cardLayout"
+					:pillLooks="refLooks"
 					:cardFieldColumns="cardFieldColumns"
 					:accentOf="cardAccent"
 					:selectedIds="internalSelectedIds"
@@ -1341,8 +1349,8 @@ import { createRefLabelResolver } from '../../composables/useRefLabels.js'
 import { useSavedViewsApi } from '../../composables/useSavedViewsApi.js'
 import { METADATA_COLUMNS } from '../../constants/metadata.js'
 import { useObjectStore } from '../../store/useObjectStore.js'
-import { followItemActionLink, resolveItemActionLink, routeHref } from '../../utils/actionLink.js'
-import { buildOnSuccessRoute, resolveRegisteredHandler } from '../../utils/actionsDispatcher.js'
+import { followItemActionLink, headerActionAsLink, resolveItemActionLink, routeHref } from '../../utils/actionLink.js'
+import { buildOnSuccessRoute, isExternalActionTarget, resolveRegisteredHandler } from '../../utils/actionsDispatcher.js'
 import {
 	buildReferenceStages,
 	buildValueStages,
@@ -1763,6 +1771,8 @@ export default {
 
 	inject: {
 		cnCustomComponents: { default: () => ({}) },
+		/** The app's named formatters, provided by CnAppRoot, for the map list's pills and template tokens. */
+		cnFormatters: { default: () => ({}) },
 		/** The permissions the user holds, provided by CnAppRoot; for gated page tabs. */
 		cnPermissions: { default: () => [] },
 		/** The app config an ancestor provides, for `@config.<key>` in quick-filter labels. */
@@ -3907,11 +3917,16 @@ export default {
 		 * (unless the handler is the `'none'` keyword) emits
 		 * `@header-action({ action: id, id })`.
 		 *
+		 * An entry with `href` instead renders as a real link and is never
+		 * dispatched or emitted: an absolute `http(s)`, `mailto:`, `tel:` or
+		 * `//host/...` URL is used as written, an instance path (leading `/`) goes through
+		 * `generateUrl()`. `target: '_blank'` opens it in a new tab.
+		 *
 		 * Reserved ids (those used by built-ins on the bar — `refresh`,
 		 * `import`, `export`, `copy`, `delete`) are dropped from the
 		 * merged list with a `console.warn`.
 		 *
-		 * @type {Array<{ id: string, label: string, icon?: string, handler?: string|(() => void), route?: string, disabled?: boolean }>}
+		 * @type {Array<{ id: string, label: string, icon?: string, handler?: string|(() => void), route?: string, href?: string, target?: ('_blank'|'_self'), disabled?: boolean }>}
 		 */
 		headerActions: {
 			type: Array,
@@ -4121,6 +4136,8 @@ export default {
 			boardPrevPageSize: this.viewMode === 'board' ? ((this.pagination && this.pagination.limit) || 20) : null,
 			/** Resolved labels of reference columns: `{ [columnKey]: { [id]: label|null } }`. */
 			refLabels: {},
+			/** Colour and icon names of the records badge columns point at: `{ [columnKey]: { [id]: { color, icon } } }`. */
+			refLooks: {},
 			/** Count per tab-strip index, for the entries that asked for one; null = none. */
 			tabCounts: null,
 			// The counts of the `filterStrip` pills, by pill key ('all', 'v0', ...).
@@ -4362,7 +4379,7 @@ export default {
 		/**
 		 * The header actions that open a dialog: `type: "open-form"` (the
 		 * schema-driven create form, as the navigation's primary action opens
-		 * it) or `type: "open-modal"`, without a `handler` of their own.
+		 * it) or `type: "open-modal"`, without a `handler` or `href` of their own.
 		 * Reserved ids are left out, as in `mergedHeaderActions`.
 		 *
 		 * @spec openspec/changes/index-header-open-form/specs/index-header/spec.md#requirement-an-index-header-action-can-open-the-create-form
@@ -4374,9 +4391,18 @@ export default {
 				&& typeof entry.id === 'string'
 				&& !reserved.has(entry.id)
 				&& (entry.handler === undefined || entry.handler === null || entry.handler === '')
+				&& !entry.href
 				&& (entry.type === 'open-form' || entry.type === 'open-modal'))
 		},
 
+		/**
+		 * The header actions without reserved ids, each through
+		 * `resolveHeaderHandler` (a manifest `href` entry becomes a link with
+		 * `_dispatchSuppress`, so the page neither runs nor emits it).
+		 *
+		 * @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
+		 * @return {Array<object>}
+		 */
 		mergedHeaderActions() {
 			const reserved = new Set(['refresh', 'import', 'export', 'copy', 'delete'])
 			const merged = []
@@ -6035,6 +6061,12 @@ export default {
 		 */
 		renderedColumns() {
 			let cols = this.tableColumns
+			if (this.refLookSpecs.length > 0) {
+				const lookKeys = new Set(this.refLookSpecs.map((spec) => spec.key))
+				cols = cols.map((col) => (col && typeof col === 'object' && lookKeys.has(col.key)
+					? { ...col, widgetProps: { ...(col.widgetProps || {}), looks: this.refLooks[col.key] || {} } }
+					: col))
+			}
 			if (this.refLabelSpecs.length > 0) {
 				const byKey = new Map(this.refLabelSpecs.map((s) => [s.key, s]))
 				cols = cols.map((col) => {
@@ -6105,6 +6137,108 @@ export default {
 		 *
 		 * @return {Object<string, string[]>} Distinct ids per column key.
 		 */
+		/**
+		 * The pills that take their tone and icon from the record they point at
+		 * (`resolve: { colorField?, iconField?, register?, schema? }`): badge
+		 * columns and the list view's leading and trailing cells
+		 * (`widgetProps.resolve`), the board card's pill (`board.card.resolve`)
+		 * and the record card's pills (`cardLayout` headPill, footerPill, chips).
+		 * Register and schema default to the field's reference in the schema.
+		 *
+		 * @return {Array<{key: string, register: string, schema: string, colorField: string, iconField: string}>} The specs.
+		 * @spec openspec/changes/pill-color-field/specs/pill-color-field/spec.md#requirement-a-badge-cell-takes-its-tone-and-icon-from-the-referenced-record
+		 */
+		refLookSpecs() {
+			const list = this.listConfig || {}
+			const listCells = [list.leading, ...(Array.isArray(list.trailing) ? list.trailing : [list.trailing])]
+			const badgeSources = [...this.tableColumns, ...listCells]
+				.filter((c) => c && typeof c === 'object' && c.widget === 'badge' && c.widgetProps)
+				.map((c) => ({ key: c.key, resolve: c.widgetProps.resolve }))
+			// The board card's pill (`board.card.pill` with `board.card.resolve`)
+			// and the record card's pills (`cardLayout` headPill, footerPill,
+			// chips, each with its own `resolve`).
+			const card = this.board && this.board.card && typeof this.board.card === 'object' ? this.board.card : {}
+			const layout = this.cardLayout && typeof this.cardLayout === 'object' ? this.cardLayout : {}
+			const layoutPills = [layout.headPill, layout.footerPill, ...(Array.isArray(layout.chips) ? layout.chips : [])]
+				.filter((def) => def && typeof def === 'object')
+				.map((def) => ({ key: def.field, resolve: def.resolve }))
+			// The map list's pills (`mapConfig.list.pills`, each with its own `resolve`).
+			const mapListPills = (this.mapListEnabled && Array.isArray(this.mapConfig.list.pills) ? this.mapConfig.list.pills : [])
+				.filter((def) => def && typeof def === 'object')
+				.map((def) => ({ key: def.path, resolve: def.resolve }))
+			const seen = new Set()
+			const cols = [...badgeSources, { key: card.pill, resolve: card.resolve }, ...layoutPills, ...mapListPills].filter((c) => {
+				const wanted = typeof c.key === 'string' && c.key !== '' && c.resolve && typeof c.resolve === 'object'
+					&& (c.resolve.colorField || c.resolve.iconField) && !seen.has(c.key)
+				if (wanted) {
+					seen.add(c.key)
+				}
+				return wanted
+			})
+			if (cols.length === 0) {
+				return []
+			}
+			const fields = this.effectiveSchema ? fieldsFromSchema(this.effectiveSchema, { includeReadOnly: true }) : []
+			const specs = []
+			for (const col of cols) {
+				const resolve = col.resolve
+				const field = fields.find((f) => f.key === col.key)
+				const ref = (field && field.reference) || {}
+				const register = resolve.register || ref.register || (typeof this.register === 'string' ? this.register : '')
+				const schema = resolve.schema || (ref.schema !== undefined && ref.schema !== null ? String(ref.schema) : '')
+				if (!register || !schema) {
+					continue
+				}
+				specs.push({ key: col.key, register, schema, colorField: resolve.colorField || '', iconField: resolve.iconField || '' })
+			}
+			return specs
+		},
+
+		/**
+		 * `listConfig` with the referenced records' looks on its badge cells,
+		 * as `renderedColumns` does for the table.
+		 *
+		 * @return {object} The list view's config.
+		 * @spec openspec/changes/pill-color-field/specs/pill-color-field/spec.md#requirement-a-badge-cell-takes-its-tone-and-icon-from-the-referenced-record
+		 */
+		renderedListConfig() {
+			const list = this.listConfig
+			if (!list || this.refLookSpecs.length === 0) {
+				return list
+			}
+			const lookKeys = new Set(this.refLookSpecs.map((spec) => spec.key))
+			const withLooks = (cell) => (cell && typeof cell === 'object' && lookKeys.has(cell.key)
+				? { ...cell, widgetProps: { ...(cell.widgetProps || {}), looks: this.refLooks[cell.key] || {} } }
+				: cell)
+			return {
+				...list,
+				...(list.leading ? { leading: withLooks(list.leading) } : {}),
+				...(list.trailing ? { trailing: Array.isArray(list.trailing) ? list.trailing.map(withLooks) : withLooks(list.trailing) } : {}),
+			}
+		},
+
+		/**
+		 * The ids each `refLookSpecs` column shows on screen.
+		 *
+		 * @return {{[key: string]: Array<string>}} Sorted ids by column key.
+		 */
+		refLookIds() {
+			const out = {}
+			for (const spec of this.refLookSpecs) {
+				const ids = new Set()
+				for (const row of this.displayObjects) {
+					const v = row ? row[spec.key] : undefined
+					;(Array.isArray(v) ? v : [v]).forEach((id) => {
+						if (id !== null && id !== undefined && id !== '' && typeof id !== 'object') {
+							ids.add(String(id))
+						}
+					})
+				}
+				out[spec.key] = [...ids].sort()
+			}
+			return out
+		},
+
 		refLabelIds() {
 			const out = {}
 			const facets = this.storeFacets || this.resolvedSidebar.facets || {}
@@ -6372,13 +6506,15 @@ export default {
 			const translated = {
 				...list,
 				title: this.cnTranslate(list.title),
-				sub: list.sub ? this.cnTranslate(list.sub) : '',
+				sub: Array.isArray(list.sub) ? list.sub.map((s) => this.cnTranslate(s)) : (list.sub ? this.cnTranslate(list.sub) : ''),
 				due: list.due ? this.cnTranslate(list.due) : '',
 			}
 			return mapListItems(this.displayObjects, translated, {
 				rowKey: this.rowKey,
 				located: (row) => Boolean(this.resolveRowGeometry(row)),
 				translate: (text) => this.cnTranslate(text),
+				formatters: this.cnFormatters,
+				looks: this.refLooks,
 			})
 		},
 
@@ -7305,11 +7441,13 @@ export default {
 		 *
 		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-an-index-page-can-take-the-board-header
 		 * @spec openspec/changes/screens-index-header-buttons-parity/specs/index-list-board-look/spec.md#requirement-the-add-header-button-carries-a-plus
-		 * @return {Array<{key: string, label: string, action: string, variant: string, icon: string, format: string}>}
+		 * @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
+		 * @return {Array<{key: string, label: string, action: string, variant: string, icon: string, format: string, link: ({href: string, target: (string|undefined)}|null)}>}
 		 */
 		resolvedHeaderButtons() {
 			const headerButtons = this.presented('headerButtons')
 			const declared = Array.isArray(headerButtons) ? headerButtons : []
+			const builtInActions = new Set(['add', 'export', 'import', 'refresh', 'save-view', 'actions-menu'])
 			return declared
 				.filter((button) => button && typeof button === 'object' && typeof button.action === 'string' && button.action !== '')
 				.map((button, index) => {
@@ -7336,6 +7474,13 @@ export default {
 					if (label === '' && button.action === 'save-view') {
 						label = t('nextcloud-vue', 'Save view')
 					}
+					const run = typeof button.run === 'string' ? button.run : ''
+					// A button that runs a manifest `href` header action is that link;
+					// a `type: "navigate"` or function-handler entry keeps dispatching.
+					const actionId = button.action === 'export' ? run : (builtInActions.has(button.action) ? '' : button.action)
+					const linked = actionId
+						? this.mergedHeaderActions.find((entry) => entry && entry.id === actionId && entry.href && entry._dispatchSuppress && (!entry.type || entry.type === 'handler'))
+						: null
 					return {
 						key: String(button.id || button.action || index),
 						label,
@@ -7343,7 +7488,8 @@ export default {
 						variant: button.variant === 'primary' ? 'primary' : 'secondary',
 						icon,
 						format: button.format === 'excel' ? 'excel' : 'csv',
-						run: typeof button.run === 'string' ? button.run : '',
+						run,
+						link: linked ? { href: linked.href, target: linked.linkTarget || undefined } : null,
 						items: Array.isArray(button.items)
 							? button.items.filter((item) => (typeof item === 'string' && item !== '')
 								|| (item && typeof item === 'object' && typeof item.heading === 'string' && item.heading !== ''))
@@ -8002,6 +8148,15 @@ export default {
 			},
 		},
 
+		// Read the colour and icon of the records badge columns point at.
+		refLookIds: {
+			immediate: true,
+			deep: true,
+			handler() {
+				this.loadRefLooks()
+			},
+		},
+
 		// The Active line names a referenced value, not its id.
 		activeFilterRefIds: {
 			deep: true,
@@ -8453,6 +8608,45 @@ export default {
 			}))
 		},
 
+		/**
+		 * Read the colour and icon names `refLookSpecs` columns need, for the
+		 * rows on screen, with the same resolver as the labels. A failure
+		 * leaves the badge as declared.
+		 *
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/pill-color-field/specs/pill-color-field/spec.md#requirement-a-badge-cell-takes-its-tone-and-icon-from-the-referenced-record
+		 */
+		async loadRefLooks() {
+			if (this.refLookSpecs.length === 0) {
+				return
+			}
+			if (!this._refLabelResolver) {
+				this._refLabelResolver = createRefLabelResolver(() => {
+					try {
+						return (this.list && this.list.objectStore) || useObjectStore()
+					} catch {
+						return null
+					}
+				})
+			}
+			const read = (spec, ids, name) => (name
+				? this._refLabelResolver.resolve(spec.register, spec.schema, ids, name, { strict: true }).catch(() => ({}))
+				: Promise.resolve({}))
+			await Promise.all(this.refLookSpecs.map(async (spec) => {
+				const known = this.refLooks[spec.key] || {}
+				const ids = (this.refLookIds[spec.key] || []).filter((id) => !Object.hasOwn(known, id))
+				if (ids.length === 0) {
+					return
+				}
+				const [colors, icons] = await Promise.all([read(spec, ids, spec.colorField), read(spec, ids, spec.iconField)])
+				const found = {}
+				ids.forEach((id) => {
+					found[id] = { color: (colors && colors[id]) || null, icon: (icons && icons[id]) || null }
+				})
+				this.refLooks = { ...this.refLooks, [spec.key]: { ...(this.refLooks[spec.key] || {}), ...found } }
+			}))
+		},
+
 		/**
 		 * Whether a saved view shows its record count (`viewCounts`).
 		 *
@@ -8953,8 +9147,11 @@ export default {
 		 * manifest-actions-dispatch — `navigate`, `emit`, `none`, or a
 		 * registry name (resolved through `resolveRegisteredHandler`).
 		 *
+		 * @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 Raw headerActions entry.
-		 * @return {object} Possibly-mutated copy: function-typed
+		 * @return {object} Possibly-mutated copy: an `href` becomes a
+		 *   resolved link with `linkTarget`, no handler (a function one
+		 *   included) and `_dispatchSuppress: true`; function-typed
 		 *   handlers untouched; `'emit'` and unknown registry names
 		 *   strip the `handler` (emit-only fall-through); `'navigate'`
 		 *   becomes a `$router.push` thunk (with the entry's literal
@@ -8966,14 +9163,23 @@ export default {
 			if (!entry) {
 				return entry
 			}
+			// An `href` makes the entry a link, which only navigates: it
+			// carries no handler, and the page emits nothing for it.
+			if (typeof entry.href === 'string' && entry.href !== '') {
+				const link = headerActionAsLink(entry)
+				return link.href ? { ...link, linkTarget: link.target, _dispatchSuppress: true } : link
+			}
 			const handler = entry.handler
 			if (typeof handler === 'function') {
 				return { ...entry }
 			}
 			// `type: "navigate"` with a `target` URL is a link: the bar and the
-			// header's Actions menu render it as a real anchor in a new tab.
+			// header's Actions menu render it as a real anchor, an external URL
+			// in a new tab.
 			if (typeof handler !== 'string' && entry.type === 'navigate' && typeof entry.target === 'string' && entry.target !== '' && !entry.href) {
-				return { ...entry, href: entry.target }
+				return isExternalActionTarget(entry.target)
+					? { ...entry, href: entry.target, linkTarget: '_blank' }
+					: { ...entry, href: entry.target }
 			}
 			if (typeof handler !== 'string') {
 				// No handler declared — emit-only fall-through.
@@ -9144,8 +9350,9 @@ export default {
 		 *
 		 * @spec openspec/changes/screens-index-header-actions-menu/specs/index-header/spec.md#requirement-the-header-actions-menu-lists-what-its-items-name
 		 * @spec openspec/changes/screens-index-header-menu-headings/specs/index-header/spec.md#requirement-the-header-actions-menu-can-draw-group-headings-and-separators
+		 * @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 {{items?: Array<(string|{heading: string})>|null, format?: string}} button The resolved header button.
-		 * @return {Array<{key: string, label: string, kind?: ('heading'|'separator'), icon?: string, href?: string, disabled?: boolean, title?: string, iconComponent?: object, run?: Function}>}
+		 * @return {Array<{key: string, label: string, kind?: ('heading'|'separator'), icon?: string, href?: string, linkTarget?: string, disabled?: boolean, title?: string, iconComponent?: object, run?: () => void}>}
 		 */
 		headerMenuEntries(button) {
 			const fromAction = (entry) => ({
@@ -9153,6 +9360,7 @@ export default {
 				label: entry.label ? this.cnTranslate(entry.label) : '',
 				icon: entry.icon && typeof entry.icon === 'string' && !entry.icon.startsWith('icon-') ? entry.icon : '',
 				href: typeof entry.href === 'string' && entry.href !== '' ? entry.href : '',
+				linkTarget: entry.linkTarget || '',
 				// A `handler: "navigate"` entry whose route resolves carries `to`
 				// (resolveHeaderHandler drops its handler): the menu draws it as
 				// an in-app link, as the actions bar does, so it navigates.
@@ -9186,7 +9394,7 @@ export default {
 				}),
 
 				documentation: () => (this.documentationUrl
-					? { key: 'documentation', label: this.documentationLabel || t('nextcloud-vue', 'Documentation'), icon: 'BookOpenVariantOutline', href: this.documentationUrl }
+					? { key: 'documentation', label: this.documentationLabel || t('nextcloud-vue', 'Documentation'), icon: 'BookOpenVariantOutline', href: this.documentationUrl, linkTarget: '_blank' }
 					: null),
 			}
 			const entries = []
@@ -9282,13 +9490,18 @@ export default {
 
 		/**
 		 * A header button was clicked: run its built-in action, or dispatch
-		 * it as the `headerActions` entry with that id.
+		 * it as the `headerActions` entry with that id. A button that is a
+		 * link is left to the browser.
 		 *
 		 * @spec openspec/changes/zuiddrecht-pixel-gaps-3/specs/zuiddrecht-pixel-gaps-3/spec.md#requirement-an-index-page-can-take-the-board-header
-		 * @param {{action: string, format: string}} button The resolved button.
+		 * @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 {{action: string, format: string, link?: object}} button The resolved button.
 		 * @return {void}
 		 */
 		onHeaderButton(button) {
+			if (button.link) {
+				return
+			}
 			if (button.action === 'add') {
 				this.onAddClick()
 			} else if (button.action === 'export') {
@@ -11614,7 +11827,7 @@ export default {
 				return
 			}
 			const badge = this.savedViewMenuBadge(view)
-			menu.toggle({ id: String(view.id || view.slug), page: this.savedViewPage, name: view.name, ...(badge ? { badge } : {}) })
+			menu.toggle({ id: String(view.id || view.slug), page: this.savedViewPage, name: view.name, ...(typeof view.icon === 'string' && view.icon !== '' ? { icon: view.icon } : {}), ...(badge ? { badge } : {}) })
 		},
 
 		/**
@@ -12149,7 +12362,9 @@ export default {
 			if (resultData && resultData.success && this._refLabelResolver) {
 				this._refLabelResolver.invalidate()
 				this.refLabels = {}
+				this.refLooks = {}
 				this.loadRefLabels()
+				this.loadRefLooks()
 			}
 		},
 

package/src/components/CnNcDashboardList/CnNcDashboardList.vue

@@ -32,6 +32,7 @@
 import { translate as t } from '@nextcloud/l10n'
 import { generateUrl } from '@nextcloud/router'
 import { fetchEndpointSource } from '../../composables/useEndpointSource.js'
+import { resolveDue } from '../../utils/dueText.js'
 import { fillTemplate } from '../../utils/fillTemplate.js'
 import { openRowTarget } from '../../utils/linkNavigation.js'
 import { readPath } from '../../utils/readPath.js'
@@ -70,6 +71,9 @@ function appUrl(url) {
  * - `itemsPath`: the rows' path in the response, when not `results`.
  * - `limit`: the most rows shown (default 7).
  * - `title`, `subtitle`: templates filled from a row (default `{title}`, none).
+ * - `due`: `{ field, ...dueText config }`: the trailing line says how a date
+ *   stands ("3 days overdue", "Due today", the date or the days left), in
+ *   place of `subtitle` (see `resolveDue`).
  * - `href`: a template for a row's page (`/apps/dossiq/cases/{id}`).
  * - `viewAll`: `{ href, label? }`.
  * - `emptyText`: text for an empty list.
@@ -125,7 +129,7 @@ export default {
 				return {
 					id: String(id),
 					mainText: this.fill(this.config.title || '{title}', item) || String(id),
-					subText: this.fill(this.config.subtitle, item),
+					subText: this.subtitleOf(item),
 					href: this.config.href ? appUrl(fillTemplate(this.config.href, { ...item, id })) : '',
 				}
 			})
@@ -155,6 +159,22 @@ export default {
 			return typeof value === 'string' && value !== '' ? this.cnTranslate(value) : ''
 		},
 
+		/**
+		 * A row's trailing line: how its due date stands, or the subtitle template.
+		 *
+		 * @spec openspec/changes/nc-dashboard-due/specs/nc-dashboard-widgets/spec.md#requirement-a-dashboard-row-says-how-its-date-stands
+		 * @param {object} item The row.
+		 * @return {string}
+		 */
+		subtitleOf(item) {
+			const due = this.config.due
+			if (due && typeof due === 'object' && due.field) {
+				const resolved = resolveDue(readPath(item, due.field), due, (text) => this.cnTranslate(text))
+				return resolved ? resolved.text : ''
+			}
+			return this.fill(this.config.subtitle, item)
+		},
+
 		/**
 		 * A template filled from a row, translated first.
 		 *

package/src/components/CnObjectCard/CnObjectCard.md

@@ -138,6 +138,7 @@ export default {
 |---|---|---|---|
 | `maxMetadata` | `Number` | `4` | Maximum number of schema properties to show in the metadata section. Properties are sorted by their `order` value before slicing |
 | `accent` | `Object` | `null` | Status accent `{ variant, icon?, label? }`: a colored start border and, with `icon`, a colored icon before the title. `variant` is `success`, `warning`, `error`, `info` or `primary`; `label` is the icon's tooltip and accessible name |
+| `pillLooks` | `Object` | `{}` | The referenced records' colour and icon names, by field and id (`{ [field]: { [id]: { color, icon } } }`, read by CnIndexPage). A record layout pill with `resolve: { colorField?, iconField? }` takes its record's tone and icon from here. |
 
 ## Slots
 

package/src/components/CnObjectCard/CnObjectCard.vue

@@ -24,7 +24,11 @@
 					class="cn-object-card__record-pill"
 					:label="recordHeadPill.label"
 					:variant="recordHeadPill.variant"
-					data-testid="cn-object-card-head-pill" />
+					data-testid="cn-object-card-head-pill">
+					<template v-if="recordHeadPill.icon" #icon>
+						<CnIcon :name="recordHeadPill.icon" :size="14" />
+					</template>
+				</CnStatusBadge>
 				<span v-if="recordNumber" class="cn-object-card__record-number" data-testid="cn-object-card-number">{{ recordNumber }}</span>
 				<div
 					v-if="$slots.actions"
@@ -63,7 +67,11 @@
 					:key="chip.field"
 					class="cn-object-card__record-pill"
 					:label="chip.label"
-					:variant="chip.variant" />
+					:variant="chip.variant">
+					<template v-if="chip.icon" #icon>
+						<CnIcon :name="chip.icon" :size="14" />
+					</template>
+				</CnStatusBadge>
 			</div>
 			<div v-if="$slots.badges" class="cn-object-card__badges">
 				<slot name="badges" :object="object" />
@@ -74,7 +82,11 @@
 					class="cn-object-card__record-pill"
 					:label="recordFootPill.label"
 					:variant="recordFootPill.variant"
-					data-testid="cn-object-card-foot-pill" />
+					data-testid="cn-object-card-foot-pill">
+					<template v-if="recordFootPill.icon" #icon>
+						<CnIcon :name="recordFootPill.icon" :size="14" />
+					</template>
+				</CnStatusBadge>
 				<span
 					v-if="recordDate"
 					class="cn-object-card__record-date"
@@ -207,6 +219,7 @@ import { normalizeLook } from '../../composables/useLook.js'
 import { isBadgeVariant } from '../../utils/badgeVariants.js'
 import { formatBoardDate } from '../../utils/boardDate.js'
 import { resolveDateVariant } from '../../utils/dateVariant.js'
+import { pillLook } from '../../utils/detailActionModel.js'
 import { resolveDue } from '../../utils/dueText.js'
 import { readPath } from '../../utils/readPath.js'
 import { resolveImageUrl } from '../../utils/resolveImageUrl.js'
@@ -375,6 +388,20 @@ export default {
 			default: null,
 		},
 
+		/**
+		 * The referenced records' colour and icon names, by field and id
+		 * (`{ [field]: { [id]: { color, icon } } }`, CnIndexPage reads them).
+		 * A record layout pill with `resolve: { colorField?, iconField? }` takes
+		 * its record's tone and icon from here.
+		 *
+		 * @type {object}
+		 * @spec openspec/changes/pill-color-field/specs/pill-color-field/spec.md#requirement-a-card-pill-takes-its-tone-and-icon-from-the-referenced-record
+		 */
+		pillLooks: {
+			type: Object,
+			default: () => ({}),
+		},
+
 		/**
 		 * The property keys the facts list shows, in order (manifest key
 		 * `config.cardFields`). Without it the card shows the first
@@ -588,7 +615,7 @@ export default {
 					const labels = def.labels && typeof def.labels === 'object' ? def.labels : {}
 					const shown = typeof labels[String(raw)] === 'string' ? this.cnTranslate(labels[String(raw)]) : label
 					const variant = mapped || def.variant
-					return { field: def.field, label: shown, variant: isBadgeVariant(variant) ? variant : 'default' }
+					return this.withLook({ field: def.field, label: shown, variant: isBadgeVariant(variant) ? variant : 'default' }, def)
 				})
 				.filter(Boolean)
 		},
@@ -838,7 +865,26 @@ export default {
 			const colorMap = def.colorMap && typeof def.colorMap === 'object' ? def.colorMap : {}
 			const key = Object.keys(colorMap).find((k) => k.toLowerCase() === value.toLowerCase())
 			const variant = key !== undefined ? colorMap[key] : def.variant
-			return { label, variant: isBadgeVariant(variant) ? variant : 'default' }
+			return this.withLook({ label, variant: isBadgeVariant(variant) ? variant : 'default' }, def)
+		},
+
+		/**
+		 * Lay the referenced record's tone and icon over a layout pill that
+		 * declares `resolve` (see `pillLooks`).
+		 *
+		 * @param {{label: string, variant: string}} pill The pill as declared.
+		 * @param {object} def The pill's definition.
+		 * @return {{label: string, variant: string, icon?: string}} The pill.
+		 * @spec openspec/changes/pill-color-field/specs/pill-color-field/spec.md#requirement-a-card-pill-takes-its-tone-and-icon-from-the-referenced-record
+		 */
+		withLook(pill, def) {
+			if (!def || !def.resolve || !this.pillLooks || typeof this.pillLooks !== 'object') {
+				return pill
+			}
+			const looks = this.pillLooks[def.field]
+			const raw = readPath(this.object, def.field)
+			const look = pillLook(looks && raw !== null && raw !== undefined ? looks[String(raw)] : null)
+			return { ...pill, ...(look.variant ? { variant: look.variant } : {}), ...(look.icon ? { icon: look.icon } : {}) }
 		},
 
 		/**