@conduction/nextcloud-vue 2.77.0 → 2.79.0

package/l10n/en.json

@@ -1,5 +1,7 @@
 {
   "translations": {
+    "You cannot see these files": "You cannot see these files",
+    "Delete {name}? This cannot be undone here.": "Delete {name}? This cannot be undone here.",
     "Linked items": "Linked items",
     "Still loading: {sections}": "Still loading: {sections}",
     "Could not load {section}.": "Could not load {section}.",
@@ -114,6 +116,7 @@
     "Saved just now": "Saved just now",
     "Saved {time}": "Saved {time}",
     "Saved": "Saved",
+    "Draft kept on this device": "Draft kept on this device",
     "Publish": "Publish",
     "Edit {title} (draft)": "Edit {title} (draft)",
     "Also search inside files": "Also search inside files",
@@ -453,6 +456,12 @@
     "NC Activity is currently unavailable.": "NC Activity is currently unavailable.",
     "Could not load activity.": "Could not load activity.",
     "Today": "Today",
+    "Last 8 hours": "Last 8 hours",
+    "Last 24 hours": "Last 24 hours",
+    "Last 7 days": "Last 7 days",
+    "Last 30 days": "Last 30 days",
+    "Last 90 days": "Last 90 days",
+    "Custom range": "Custom range",
     "Yesterday": "Yesterday",
     "Earlier": "Earlier",
     "System": "System",
@@ -565,6 +574,8 @@
     "Order": "Order",
     "Owner:": "Owner:",
     "Page {current} of {total}": "Page {current} of {total}",
+    "{shown} of {total}": "{shown} of {total}",
+    "{from}–{to} of {total}": "{from}–{to} of {total}",
     "Parent schemas:": "Parent schemas:",
     "Password": "Password",
     "Pattern (regex)": "Pattern (regex)",
@@ -764,6 +775,27 @@
     "Message input": "Message input",
     "Start new chat": "Start new chat",
     "History": "History",
+    "No audit entries yet": "No audit entries yet",
+    "Meetings": "Meetings",
+    "No meetings": "No meetings",
+    "Open in Calendar": "Open in Calendar",
+    "(no title)": "(no title)",
+    "Could not load meetings.": "Could not load meetings.",
+    "Could not load meeting.": "Could not load meeting.",
+    "Calendar is currently unavailable.": "Calendar is currently unavailable.",
+    "Show all {count} fields": "Show all {count} fields",
+    "Show less": "Show less",
+    "{count} more": "{count} more",
+    "Identifier: {identifier}": "Identifier: {identifier}",
+    "What happened, who did it and when, newest first": "What happened, who did it and when, newest first",
+    "{app} is not installed": "{app} is not installed",
+    "Install and enable the {app} app to see this.": "Install and enable the {app} app to see this.",
+    "{title} needs the {app} app. Install and enable it to see this.": "{title} needs the {app} app. Install and enable it to see this.",
+    "View all ({total})": "View all ({total})",
+    "No items": "No items",
+    "Nothing here yet": "Nothing here yet",
+    "No items match this filter": "No items match this filter",
+    "Could not load these records": "Could not load these records",
     "No conversations yet": "No conversations yet",
     "Connecting...": "Connecting...",
     "Loading conversations...": "Loading conversations...",
@@ -1302,7 +1334,34 @@
     "Filter by {column}, active": "Filter by {column}, active",
     "Turn notifications off": "Turn notifications off",
     "Turn notifications on": "Turn notifications on",
-    "Could not change notifications.": "Could not change notifications."
+    "Could not change notifications.": "Could not change notifications.",
+    "Actions for the selection": "Actions for the selection",
+    "Active:": "Active:",
+    "Filter": "Filter",
+    "List": "List",
+    "Map": "Map",
+    "Remove filter: {label}": "Remove filter: {label}",
+    "Search and columns": "Search and columns",
+    "Sort by": "Sort by",
+    "View mode": "View mode",
+    "With the selected {plural}": "With the selected {plural}",
+    "items": "items",
+    "{count} active": "{count} active",
+    "Delete \"{name}\"": "Delete \"{name}\"",
+    "No saved views yet": "No saved views yet",
+    "No views with this label": "No views with this label",
+    "Save current view…": "Save current view…",
+    "Save view": "Save view",
+    "Saved views": "Saved views",
+    "Show only views labelled \"{label}\"": "Show only views labelled \"{label}\"",
+    "Stop filtering on \"{label}\"": "Stop filtering on \"{label}\"",
+    "{name}, level {level}": "{name}, level {level}",
+    "{name}. Parts of this view come from one you cannot see.": "{name}. Parts of this view come from one you cannot see.",
+    "More filters": "More filters",
+    "Quick filters": "Quick filters",
+    "{count} filters": "{count} filters",
+    "{count} more filters": "{count} more filters",
+    "{label} — show the other filters": "{label} — show the other filters"
   },
   "plurals": {
     "%n year": [
@@ -1313,6 +1372,10 @@
       "%n month",
       "%n months"
     ],
+    "%n hour": [
+      "%n hour",
+      "%n hours"
+    ],
     "%n day": [
       "%n day",
       "%n days"
@@ -1368,6 +1431,10 @@
     "in {count} day": [
       "in {count} day",
       "in {count} days"
+    ],
+    "{count} more filter": [
+      "{count} more filter",
+      "{count} more filters"
     ]
   }
 }

package/l10n/nl.json

@@ -1,5 +1,7 @@
 {
   "translations": {
+    "You cannot see these files": "Je kunt deze bestanden niet zien",
+    "Delete {name}? This cannot be undone here.": "{name} verwijderen? Dit kun je hier niet ongedaan maken.",
     "Linked items": "Gekoppelde items",
     "Still loading: {sections}": "Nog aan het laden: {sections}",
     "Could not load {section}.": "{section} kon niet worden geladen.",
@@ -114,6 +116,7 @@
     "Saved just now": "Zojuist opgeslagen",
     "Saved {time}": "Opgeslagen {time}",
     "Saved": "Opgeslagen",
+    "Draft kept on this device": "Concept bewaard op dit apparaat",
     "Edit {title} (draft)": "{title} bewerken (concept)",
     "Also search inside files": "Zoek ook in bestanden",
     "File matches are limited to the best 50.": "Bestandstreffers zijn beperkt tot de beste 50.",
@@ -452,6 +455,12 @@
     "NC Activity is currently unavailable.": "NC Activiteit is momenteel niet beschikbaar.",
     "Could not load activity.": "Kon activiteit niet laden.",
     "Today": "Vandaag",
+    "Last 8 hours": "Laatste 8 uur",
+    "Last 24 hours": "Laatste 24 uur",
+    "Last 7 days": "Laatste 7 dagen",
+    "Last 30 days": "Laatste 30 dagen",
+    "Last 90 days": "Laatste 90 dagen",
+    "Custom range": "Aangepaste periode",
     "Yesterday": "Gisteren",
     "Earlier": "Eerder",
     "System": "Systeem",
@@ -564,6 +573,8 @@
     "Order": "Volgorde",
     "Owner:": "Eigenaar:",
     "Page {current} of {total}": "Pagina {current} van {total}",
+    "{shown} of {total}": "{shown} van {total}",
+    "{from}–{to} of {total}": "{from}–{to} van {total}",
     "Parent schemas:": "Bovenliggende schema's:",
     "Password": "Wachtwoord",
     "Pattern (regex)": "Patroon (regex)",
@@ -762,7 +773,28 @@
     "AI assistant": "AI-assistent",
     "Message input": "Berichtinvoer",
     "Start new chat": "Nieuwe chat starten",
-    "History": "Geschiedenis",
+    "History": "Historie",
+    "No audit entries yet": "Nog geen wijzigingen vastgelegd",
+    "Meetings": "Afspraken",
+    "No meetings": "Geen afspraken",
+    "Open in Calendar": "Openen in Agenda",
+    "(no title)": "(geen titel)",
+    "Could not load meetings.": "De afspraken konden niet worden geladen.",
+    "Could not load meeting.": "De afspraak kon niet worden geladen.",
+    "Calendar is currently unavailable.": "De agenda is nu niet beschikbaar.",
+    "Show all {count} fields": "Alle {count} velden tonen",
+    "Show less": "Minder tonen",
+    "{count} more": "Nog {count}",
+    "Identifier: {identifier}": "Kenmerk: {identifier}",
+    "What happened, who did it and when, newest first": "Wat er gebeurde, door wie en wanneer, nieuwste eerst",
+    "{app} is not installed": "{app} is niet geïnstalleerd",
+    "Install and enable the {app} app to see this.": "Installeer en activeer de app {app} om dit te zien.",
+    "{title} needs the {app} app. Install and enable it to see this.": "{title} heeft de app {app} nodig. Installeer en activeer die om dit te zien.",
+    "View all ({total})": "Alles bekijken ({total})",
+    "No items": "Geen items",
+    "Nothing here yet": "Hier staat nog niets",
+    "No items match this filter": "Geen items voldoen aan dit filter",
+    "Could not load these records": "Deze gegevens konden niet worden geladen",
     "No conversations yet": "Nog geen gesprekken",
     "Connecting...": "Verbinden...",
     "Loading conversations...": "Gesprekken laden...",
@@ -1353,7 +1385,78 @@
     "Filter by {column}, active": "Filteren op {column}, actief",
     "Turn notifications off": "Meldingen uitzetten",
     "Turn notifications on": "Meldingen aanzetten",
-    "Could not change notifications.": "Meldingen konden niet worden gewijzigd."
+    "Could not change notifications.": "Meldingen konden niet worden gewijzigd.",
+    "Actions for the selection": "Acties voor de selectie",
+    "Active:": "Actief:",
+    "Filter": "Filter",
+    "List": "Lijst",
+    "Map": "Kaart",
+    "Remove filter: {label}": "Filter verwijderen: {label}",
+    "Search and columns": "Zoeken en kolommen",
+    "Sort by": "Sorteren op",
+    "View mode": "Weergave",
+    "With the selected {plural}": "Met de geselecteerde {plural}",
+    "items": "items",
+    "{count} active": "{count} actief",
+    "Delete \"{name}\"": "\"{name}\" verwijderen",
+    "No saved views yet": "Nog geen opgeslagen weergaven",
+    "No views with this label": "Geen weergaven met dit label",
+    "Save current view…": "Huidige weergave opslaan…",
+    "Save view": "Weergave opslaan",
+    "Saved views": "Opgeslagen weergaven",
+    "Show only views labelled \"{label}\"": "Alleen weergaven met label \"{label}\" tonen",
+    "Stop filtering on \"{label}\"": "Niet meer filteren op \"{label}\"",
+    "{name}, level {level}": "{name}, niveau {level}",
+    "{name}. Parts of this view come from one you cannot see.": "{name}. Delen van deze weergave komen uit een weergave die u niet kunt zien.",
+    "More filters": "Meer filters",
+    "Quick filters": "Snelfilters",
+    "{count} filters": "{count} filters",
+    "{count} more filters": "{count} filters meer",
+    "{label} — show the other filters": "{label}, toon de andere filters",
+    "A file or folder with that name is already here": "Hier staat al een bestand of map met die naam",
+    "A file with that name is already here": "Hier staat al een bestand met die naam",
+    "A name cannot contain a slash": "Een naam kan geen schuine streep bevatten",
+    "Actions for {name}": "Acties voor {name}",
+    "Download": "Downloaden",
+    "Drop files here, or use New": "Sleep bestanden hierheen, of gebruik Nieuw",
+    "Folder name": "Mapnaam",
+    "Modified": "Gewijzigd",
+    "New": "Nieuw",
+    "New folder": "Nieuwe map",
+    "New name": "Nieuwe naam",
+    "Rename": "Naam wijzigen",
+    "Show in Files": "Tonen in Bestanden",
+    "Size": "Grootte",
+    "The folder could not be created": "De map kon niet worden gemaakt",
+    "The folder could not be read": "De map kon niet worden gelezen",
+    "The name could not be changed": "De naam kon niet worden gewijzigd",
+    "The upload failed": "Het uploaden is mislukt",
+    "This folder is empty": "Deze map is leeg",
+    "This folder no longer exists": "Deze map bestaat niet meer",
+    "Try again": "Opnieuw proberen",
+    "Upload files": "Bestanden uploaden",
+    "You cannot see this folder": "Je kunt deze map niet zien",
+    "{action} did not succeed": "{action} is niet gelukt",
+    "Error:": "Fout:",
+    "optional": "optioneel",
+    "Copy link": "Link kopiëren",
+    "Details and sharing": "Details en delen",
+    "Link copied": "Link gekopieerd",
+    "Share uploaded files": "Geüploade bestanden delen",
+    "The link could not be copied": "De link kon niet worden gekopieerd",
+    "Invalid JSON: {msg}": "Ongeldige JSON: {msg}",
+    "Loading the fields this choice adds.": "De velden van deze keuze worden geladen.",
+    "Restore": "Herstellen",
+    "Save draft": "Concept opslaan",
+    "Saved {title}": "{title} opgeslagen",
+    "Saved, but some rows were not saved: {rows}": "Opgeslagen, maar sommige rijen zijn niet opgeslagen: {rows}",
+    "The list of choices could not be loaded. Enter the value by hand.": "De keuzelijst kon niet worden geladen. Vul de waarde zelf in.",
+    "You have unsaved changes from an earlier visit.": "Je hebt niet-opgeslagen wijzigingen van een eerder bezoek.",
+    "no longer offered": "niet meer beschikbaar",
+    "1 day left": "Nog 1 dag",
+    "{count} days left": "Nog {count} dagen",
+    "1 day overdue": "1 dag te laat",
+    "{count} days overdue": "{count} dagen te laat"
   },
   "plurals": {
     "%n year": [
@@ -1364,6 +1467,10 @@
       "%n maand",
       "%n maanden"
     ],
+    "%n hour": [
+      "%n uur",
+      "%n uur"
+    ],
     "%n day": [
       "%n dag",
       "%n dagen"
@@ -1419,6 +1526,10 @@
     "in {count} day": [
       "over {count} dag",
       "over {count} dagen"
+    ],
+    "{count} more filter": [
+      "Nog {count} filter",
+      "Nog {count} filters"
     ]
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.77.0",
+  "version": "2.79.0",
   "description": "Shared Vue component library for Conduction Nextcloud apps — complements @nextcloud/vue with higher-level components, OpenRegister integration, and NL Design System support",
   "homepage": "https://github.com/ConductionNL/nextcloud-vue#readme",
   "bugs": {

package/scripts/build-validators.js

@@ -148,6 +148,32 @@ if (/require\("ajv-formats/.test(moduleCode)) {
 	throw new Error('build-validators: a require("ajv-formats…") reference survived inlining — the standalone validator is not self-contained')
 }
 
+// Inline Ajv's runtime helpers for the same reason. The standalone output
+// emits `require("ajv/dist/runtime/ucs2length").default` (every `minLength` /
+// `maxLength`) and `require("ajv/dist/runtime/equal").default` (`enum` / `const`
+// on objects). Rollup turns each into a bare side-effect import that fills an
+// `__exports` object, and a consumer's webpack drops that import because the
+// library's `sideEffects` allowlist does not name it. `.default` is then
+// undefined, the validator throws "f is not a function" on the first string it
+// length-checks, and useAppManifest's catch-all kept the bundled manifest: the
+// `/api/manifest` delta never reached the navigation (observed 2026-10-10 on
+// dossiq). Both helpers are self-contained functions (fast-deep-equal recurses
+// through its own name), so their source inlines as is.
+moduleCode = moduleCode.replace(
+	/require\("ajv\/dist\/runtime\/([A-Za-z0-9_]+)"\)\.default/g,
+	(_match, name) => {
+		const fn = require(`ajv/dist/runtime/${name}`).default
+		if (typeof fn !== 'function') {
+			throw new Error(`build-validators: ajv runtime helper "${name}" is not a function and cannot be inlined`)
+		}
+		return `(${fn.toString()})`
+	},
+)
+
+if (/require\(/.test(moduleCode)) {
+	throw new Error('build-validators: a require(…) survived inlining — the standalone validator is not self-contained')
+}
+
 const banner = `// SPDX-License-Identifier: EUPL-1.2
 // Copyright (C) 2026 Conduction B.V.
 //

package/src/components/CnActionsBar/CnActionsBar.vue

@@ -18,45 +18,54 @@
 				@description Under the board look: saved views as chips and the Save view button, in row 1 after the quick-filter chips.
 			-->
 			<slot name="actions-end" />
-			<NcButton v-if="showSidebarToggle"
-				variant="secondary"
-				class="cn-actions-bar__filter-button"
-				data-testid="cn-actions-bar-filter-button"
-				:pressed="sidebarOpen"
-				@click="$emit('toggle-sidebar')">
-				<template #icon>
-					<Tune :size="18" />
-				</template>
-				{{ t('nextcloud-vue', 'Filter') }}
-				<span
-					v-if="filterCount > 0"
-					class="cn-actions-bar__filter-badge"
-					data-testid="cn-actions-bar-filter-badge"
-					:aria-label="filterCountLabel">{{ filterCount }}</span>
-			</NcButton>
-			<div v-if="showViewToggle && viewSegments.length > 1"
-				class="cn-actions-bar__view-toggle"
-				role="group"
-				:aria-label="t('nextcloud-vue', 'View')">
-				<button
-					v-for="seg in viewSegments"
-					:key="seg.mode"
-					type="button"
-					class="cn-actions-bar__view-toggle-btn"
-					:class="{ 'cn-actions-bar__view-toggle-btn--active': viewMode === seg.mode }"
-					:aria-pressed="viewMode === seg.mode"
-					:aria-label="seg.label"
-					:title="seg.label"
-					@click="$emit('view-mode-change', seg.mode)">
-					<CnIcon v-if="seg.icon"
-						:name="seg.icon"
-						:size="24"
-						class="cn-actions-bar__view-toggle-icon" />
-					<component :is="seg.fallback"
-						v-else
-						:size="24"
-						class="cn-actions-bar__view-toggle-icon" />
-				</button>
+			<!--
+				Filter and the view switch are one unit: when row 1 is full they
+				wrap together to the start of the next line (the DqZaken board),
+				never the switch alone.
+			-->
+			<div v-if="showSidebarToggle || (showViewToggle && viewSegments.length > 1)"
+				class="cn-actions-bar__view-controls"
+				data-testid="cn-actions-bar-view-controls">
+				<NcButton v-if="showSidebarToggle"
+					variant="secondary"
+					class="cn-actions-bar__filter-button"
+					data-testid="cn-actions-bar-filter-button"
+					:pressed="sidebarOpen"
+					@click="$emit('toggle-sidebar')">
+					<template #icon>
+						<Tune :size="16" />
+					</template>
+					{{ t('nextcloud-vue', 'Filter') }}
+					<span
+						v-if="filterCount > 0"
+						class="cn-actions-bar__filter-badge"
+						data-testid="cn-actions-bar-filter-badge"
+						:aria-label="filterCountLabel">{{ filterCount }}</span>
+				</NcButton>
+				<div v-if="showViewToggle && viewSegments.length > 1"
+					class="cn-actions-bar__view-toggle"
+					role="group"
+					:aria-label="t('nextcloud-vue', 'View')">
+					<button
+						v-for="seg in viewSegments"
+						:key="seg.mode"
+						type="button"
+						class="cn-actions-bar__view-toggle-btn"
+						:class="{ 'cn-actions-bar__view-toggle-btn--active': viewMode === seg.mode }"
+						:aria-pressed="viewMode === seg.mode"
+						:aria-label="seg.label"
+						:title="seg.label"
+						@click="$emit('view-mode-change', seg.mode)">
+						<CnIcon v-if="seg.icon"
+							:name="seg.icon"
+							:size="24"
+							class="cn-actions-bar__view-toggle-icon" />
+						<component :is="seg.fallback"
+							v-else
+							:size="24"
+							class="cn-actions-bar__view-toggle-icon" />
+					</button>
+				</div>
 			</div>
 		</div>
 		<div v-if="!isBoardLayout" class="cn-actions-bar__info">

package/src/components/CnAiCompanion/CnAiCompanion.vue

@@ -66,6 +66,7 @@ import CnAiChatPanel from './CnAiChatPanel.vue'
 import CnAiFloatingButton from './CnAiFloatingButton.vue'
 import { chatHealthUrl, DEFAULT_CHAT_APP_ID } from '../../composables/aiChatConfig.js'
 import { useAiChatStream } from '../../composables/useAiChatStream.js'
+import { isAppInstalled } from '../../utils/appInstalled.js'
 
 const HEALTH_TIMEOUT = 5000
 
@@ -340,6 +341,15 @@ export default {
 			}
 		},
 
+		/**
+		 * Ask the chat backend whether it can answer, and render only if so.
+		 *
+		 * Skipped without a request when the backend app is not installed for
+		 * this user.
+		 *
+		 * @return {Promise<void>}
+		 * @spec openspec/changes/no-calls-to-missing-apps-and-presence-beacon/specs/ai-companion/spec.md#requirement-the-companion-does-not-probe-a-backend-that-is-not-installed
+		 */
 		async runHealthProbe() {
 			// RETRY before hiding. A single probe makes the whole companion
 			// disappear on one slow response, and "slow" is normal: measured on a
@@ -351,6 +361,19 @@ export default {
 			//
 			// A backend that is genuinely down fails all attempts and is still
 			// reported; this only stops one unlucky request from deciding.
+			//
+			// 🔴 NO PROBE AT AN APP THAT IS NOT THERE. Nextcloud already tells
+			// the page which apps the user has (`OC.appswebroots`), so asking a
+			// missing backend for its health is a guaranteed 404, three times
+			// per page, in every console. Measured on cloud.conduction.nl
+			// (round-5 check): hermiq not installed, three
+			// `/apps/hermiq/api/chat/health` 404s on every pipelinq and dossiq
+			// page. Hidden either way; now hidden without the requests.
+			if (!isAppInstalled(this.chatAppId || DEFAULT_CHAT_APP_ID)) {
+				this.probeSucceeded = false
+				return
+			}
+
 			for (let attempt = 1; attempt <= HEALTH_PROBE_ATTEMPTS; attempt++) {
 				try {
 					const response = await axios.get(chatHealthUrl(this.chatAppId), {

package/src/components/CnAppRoot/CnAppRoot.vue

@@ -3724,6 +3724,7 @@ export default {
 		 * entry continues there (local mirror + per-user preference).
 		 *
 		 * @spec openspec/changes/walkthrough-advance-pause-resume/specs/cn-walkthrough/spec.md
+		 * @spec openspec/changes/walkthrough-autostart-and-countdown-dutch/specs/walkthrough-autostart-and-countdown-dutch/spec.md#requirement-a-tour-that-opens-on-its-own-opens-once
 		 * @param {object} progress `{ tourId, stepId, index }` from CnWalkthrough.
 		 * @return {void}
 		 */
@@ -3731,9 +3732,18 @@ export default {
 			if (!progress || !progress.tourId) {
 				return
 			}
-			// The first step of a fresh tour is where a restart lands anyway,
-			// so it costs no request.
+			// A fresh tour that opens on its own is recorded as paused at its
+			// first step, so a user who never touches it does not get it again
+			// on every page load; "Continue" in the settings brings it back.
+			// Kept out of memory so the open tour runs on as it is.
 			if (progress.index === 0 && !this.walkthroughProgressValue) {
+				persistWalkthroughProgress(this.appId, this.walkthroughConfigKey, {
+					tourId: progress.tourId,
+					stepId: progress.stepId || '',
+					index: 0,
+					version: String((this.manifest && this.manifest.version) || ''),
+					paused: true,
+				})
 				return
 			}
 			const value = {

package/src/components/CnBoardView/CnBoardView.vue

@@ -308,6 +308,7 @@
 import { translate as t } from '@nextcloud/l10n'
 import CnStatusBadge from '../CnStatusBadge/CnStatusBadge.vue'
 import { normalizeLook } from '../../composables/useLook.js'
+import { isBadgeVariant } from '../../utils/badgeVariants.js'
 import { buildBoardColumns, resolveStageColor } from '../../utils/boardColumns.js'
 import { buildSwimlanes } from '../../utils/boardSwimlanes.js'
 import { DROP_OUTCOMES, runBoardDrop } from '../../utils/boardTransition.js'
@@ -688,7 +689,7 @@ export default {
 		pillVariant(card) {
 			const raw = this.textOf(readPath(card, this.roles.pill))
 			const variant = this.roles.pillColors[raw] ?? this.roles.pillColors[raw.toLowerCase()]
-			return ['default', 'primary', 'success', 'warning', 'error', 'info'].includes(variant) ? variant : 'default'
+			return isBadgeVariant(variant) ? variant : 'default'
 		},
 
 		/**

package/src/components/CnCellRenderer/CnCellRenderer.md

@@ -89,6 +89,7 @@ fall back to the normal rendering. See `docs/migrating-to-manifest.md` →
 Column widget — `widget="badge"`, `widget="fkResolve"` (uuid → related object label via the shared object store with per-schema caching; config `widgetProps { register, schema, labelField }`), and `widget="link"` are built-in; any other id resolves against the app's `cellWidgets` registry (`CnAppRoot`'s `cellWidgets` prop → `cnCellWidgets`), and that component receives `{ value, row, property, formatted, ...widgetProps }`. `widget` takes precedence over `formatter`; when both are set the widget gets the formatter-shaped value as `formatted`. See `docs/migrating-to-manifest.md` → "Column widgets" + "Built-in cell formatters / widgets".
 
 - `widget="badge"` — `CnStatusBadge` pill; `widgetProps.variant` picks the colour.
+  An enum value shows its `x-enum-labels` label, translated, as the plain enum cell does; a column `formatter` still wins. `widgetProps.colorMap` is looked up by the stored value when it has an entry for it, else by the label. The `link` widget and the `swatch` format show the same label.
 - `widget="link"` — `<router-link>` when `widgetProps.route` is a manifest page id, or when `widgetProps.routeMap` maps the row's `widgetProps.routeField` value to one (a value the map does not hold falls back to `route`, then to text); `<a target="_blank">` when `widgetProps.href` is set (with `{key}` placeholders substituted from the row); plain text + once-per-session `console.warn` when neither resolves (silence with `widgetProps.fallback:"silent"`). For non-`id` route params: `widgetProps.params: { routeParam: "rowField" }`. Default param map is `{ id: row[rowKey] }` — see the `row-key` prop below.
 
 ```vue