@conduction/nextcloud-vue 2.79.0 → 2.81.0

package/l10n/en.json

@@ -54,6 +54,7 @@
     "Could not update the view \"{name}\"": "Could not update the view \"{name}\"",
     "Unread": "Unread",
     "Mark as unread": "Mark as unread",
+    "Open sidebar": "Open sidebar",
     "Could not mark this record as unread.": "Could not mark this record as unread.",
     "Add to favourites": "Add to favourites",
     "Remove from favourites": "Remove from favourites",
@@ -67,6 +68,7 @@
     "Follow this record to get its updates": "Follow this record to get its updates",
     "You will see it under Following. This register sends no change notifications.": "You will see it under Following. This register sends no change notifications.",
     "Since {date}": "Since {date}",
+    "since {date}": "since {date}",
     "Remove {name} as a follower": "Remove {name} as a follower",
     "Could not change following.": "Could not change following.",
     "Could not add this colleague.": "Could not add this colleague.",
@@ -226,6 +228,7 @@
     "Access URL": "Access URL",
     "Action": "Action",
     "Actions": "Actions",
+    "optional": "optional",
     "Add": "Add",
     "Add condition": "Add condition",
     "Add enum value": "Add enum value",
@@ -300,6 +303,9 @@
     "Constant": "Constant",
     "Copy": "Copy",
     "Copied": "Copied",
+    "Show": "Show",
+    "Copy {label}": "Copy {label}",
+    "Show {label}": "Show {label}",
     "Copy item": "Copy item",
     "Copy items": "Copy items",
     "Copy of {name}": "Copy of {name}",
@@ -794,6 +800,7 @@
     "View all ({total})": "View all ({total})",
     "No items": "No items",
     "Nothing here yet": "Nothing here yet",
+    "This list could not be loaded.": "This list could not be loaded.",
     "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",
@@ -1361,9 +1368,21 @@
     "Quick filters": "Quick filters",
     "{count} filters": "{count} filters",
     "{count} more filters": "{count} more filters",
-    "{label} — show the other filters": "{label} — show the other filters"
+    "{label} — show the other filters": "{label} — show the other filters",
+    "Select {name}": "Select {name}",
+    "Select all files": "Select all files",
+    "No files match the filter.": "No files match the filter.",
+    "Actions for the selected files": "Actions for the selected files",
+    "{view}: not available on this list": "{view}: not available on this list",
+    "Leave this field empty": "Leave this field empty",
+    "This answer was refused.": "This answer was refused.",
+    "No value ({count})": "No value ({count})"
   },
   "plurals": {
+    "{count} selected": [
+      "{count} selected",
+      "{count} selected"
+    ],
     "%n year": [
       "%n year",
       "%n years"

package/l10n/nl.json

@@ -54,6 +54,7 @@
     "Could not update the view \"{name}\"": "Weergave \"{name}\" kon niet worden bijgewerkt",
     "Unread": "Ongelezen",
     "Mark as unread": "Markeren als ongelezen",
+    "Open sidebar": "Zijbalk openen",
     "Could not mark this record as unread.": "Dit dossier kon niet als ongelezen worden gemarkeerd.",
     "Add to favourites": "Aan favorieten toevoegen",
     "Remove from favourites": "Uit favorieten verwijderen",
@@ -67,6 +68,7 @@
     "Follow this record to get its updates": "Volg dit dossier om de wijzigingen te ontvangen",
     "You will see it under Following. This register sends no change notifications.": "U ziet het onder Volgend. Dit register stuurt geen wijzigingsmeldingen.",
     "Since {date}": "Sinds {date}",
+    "since {date}": "sinds {date}",
     "Remove {name} as a follower": "{name} als volger verwijderen",
     "Could not change following.": "Volgen kon niet worden gewijzigd.",
     "Could not add this colleague.": "Deze collega kon niet worden toegevoegd.",
@@ -170,6 +172,52 @@
     "No integrations available yet.": "Nog geen integraties beschikbaar.",
     "This integration is not available.": "Deze integratie is niet beschikbaar.",
     "Integrations": "Integraties",
+    "User settings": "Persoonlijke instellingen",
+    "Personal settings": "Persoonlijke instellingen",
+    "Admin settings": "Beheerinstellingen",
+    "Main navigation": "Hoofdnavigatie",
+    "Credentials": "Inloggegevens",
+    "Notifications": "Meldingen",
+    "Walkthrough": "Rondleiding",
+    "Take the guided tour of this app again.": "Doe de rondleiding door deze app nog een keer.",
+    "Restart walkthrough": "Rondleiding opnieuw starten",
+    "These open in another app.": "Deze openen in een andere app.",
+    "Notification preferences unavailable": "Meldingsvoorkeuren niet beschikbaar",
+    "Notification preferences are provided by OpenRegister and could not be loaded here.": "Meldingsvoorkeuren komen uit OpenRegister en konden hier niet worden geladen.",
+    "No notifications": "Geen meldingen",
+    "This app has no notifications.": "Deze app stuurt geen meldingen.",
+    "Choose which notifications you want to receive. Items you leave unchanged use the app default.": "Kies welke meldingen je wilt krijgen. Wat je niet aanpast, volgt de standaard van de app.",
+    "Reset to default": "Standaard herstellen",
+    "Could not save notification preference": "De meldingsvoorkeur kon niet worden opgeslagen",
+    "Could not reset notification preference": "De meldingsvoorkeur kon niet worden hersteld",
+    "When an item is created": "Als een item is aangemaakt",
+    "When an item is updated": "Als een item is gewijzigd",
+    "When an item is assigned or changes status": "Als een item is toegewezen of van status verandert",
+    "Learn about Keepiq": "Meer over Keepiq",
+    "What {app} uses": "Wat {app} gebruikt",
+    "This app does not use any external credentials.": "Deze app gebruikt geen inloggegevens van andere diensten.",
+    "Credentials are provided by OpenRegister and could not be loaded here.": "Inloggegevens komen uit OpenRegister en konden hier niet worden geladen.",
+    "Organisation credentials": "Inloggegevens van de organisatie",
+    "Your credentials": "Jouw inloggegevens",
+    "No credentials stored yet.": "Je hebt nog geen inloggegevens opgeslagen.",
+    "Confirm delete": "Verwijderen bevestigen",
+    "{app} may use this credential": "{app} mag deze inloggegevens gebruiken",
+    "Also allowed for: {apps}": "Ook toegestaan voor: {apps}",
+    "Allowed apps": "Toegestane apps",
+    "No app may use this credential yet": "Nog geen app mag deze inloggegevens gebruiken",
+    "Add credential": "Inloggegevens toevoegen",
+    "Which credential do you want to add?": "Welke inloggegevens wil je toevoegen?",
+    "Open {provider}": "{provider} openen",
+    "A label to recognise this credential later.": "Een naam waaraan je deze inloggegevens later herkent.",
+    "Secret": "Geheim",
+    "Sent to OpenRegister and stored in Keepiq. It is never shown again.": "Gaat naar OpenRegister en wordt in Keepiq bewaard. Je ziet het hierna nooit meer.",
+    "Choose which apps may use it": "Kies welke apps ze mogen gebruiken",
+    "{app} will be allowed to use this credential. You can change that afterwards.": "{app} mag deze inloggegevens gebruiken. Dat kun je later aanpassen.",
+    "This app": "Deze app",
+    "Could not save the credential": "De inloggegevens konden niet worden opgeslagen",
+    "Could not delete the credential": "De inloggegevens konden niet worden verwijderd",
+    "Could not update the credential": "De inloggegevens konden niet worden bijgewerkt",
+    "Could not update allowed apps": "De toegestane apps konden niet worden bijgewerkt",
     "View": "Bekijken",
     "Views": "Weergaven",
     "current step": "huidige stap",
@@ -225,6 +273,7 @@
     "Access URL": "Toegangs-URL",
     "Action": "Actie",
     "Actions": "Acties",
+    "optional": "niet verplicht",
     "Add": "Toevoegen",
     "Add condition": "Voorwaarde toevoegen",
     "Add enum value": "Opsommingswaarde toevoegen",
@@ -299,6 +348,9 @@
     "Constant": "Constante",
     "Copy": "Kopiëren",
     "Copied": "Gekopieerd",
+    "Show": "Tonen",
+    "Copy {label}": "{label} kopiëren",
+    "Show {label}": "{label} tonen",
     "Copy item": "Item kopiëren",
     "Copy items": "Items kopiëren",
     "Copy of {name}": "Kopie van {name}",
@@ -569,6 +621,10 @@
     "Open": "Openen",
     "Open access:": "Openbare toegang:",
     "Open row": "Rij openen",
+    "Select all rows": "Alle rijen selecteren",
+    "Select row": "Rij selecteren",
+    "Scrollable table": "Scrollbare tabel",
+    "{title} — scrollable table": "{title}, scrollbare tabel",
     "Operator": "Operator",
     "Order": "Volgorde",
     "Owner:": "Eigenaar:",
@@ -793,6 +849,7 @@
     "View all ({total})": "Alles bekijken ({total})",
     "No items": "Geen items",
     "Nothing here yet": "Hier staat nog niets",
+    "This list could not be loaded.": "Deze lijst kon niet worden geladen.",
     "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",
@@ -1438,7 +1495,6 @@
     "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",
@@ -1456,9 +1512,21 @@
     "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"
+    "{count} days overdue": "{count} dagen te laat",
+    "Select {name}": "{name} selecteren",
+    "Select all files": "Alle bestanden selecteren",
+    "No files match the filter.": "Geen bestanden passen bij het filter.",
+    "Actions for the selected files": "Acties voor de geselecteerde bestanden",
+    "{view}: not available on this list": "{view}: niet beschikbaar in deze lijst",
+    "Leave this field empty": "Laat dit veld leeg",
+    "This answer was refused.": "Dit antwoord is geweigerd.",
+    "No value ({count})": "Geen waarde ({count})"
   },
   "plurals": {
+    "{count} selected": [
+      "{count} geselecteerd",
+      "{count} geselecteerd"
+    ],
     "%n year": [
       "%n jaar",
       "%n jaar"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.79.0",
+  "version": "2.81.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": {
@@ -72,6 +72,7 @@
     "check:css-entry": "node scripts/check-css-entry.js",
     "check:dist-sideeffects": "node scripts/check-dist-sideeffects.mjs",
     "check:docs": "node scripts/check-docs.js",
+    "check:docs-mdx": "node scripts/check-docs-mdx.mjs",
     "check:docs-fresh": "cd docusaurus && npm run prebuild:docs && cd .. && node scripts/check-docs-fresh.js",
     "check:integration-parity": "node scripts/check-integration-parity.js",
     "check:journey-vocabulary": "node scripts/gates/journey-vocabulary.mjs .",

package/scripts/check-docs-mdx.mjs

@@ -0,0 +1,108 @@
+/**
+ * Compiles every page under docs/ the way the Docusaurus site does (MDX 3,
+ * GFM, directives), and fails on the first class of error that breaks the
+ * site build: a `<word>` read as a JSX tag, a `{` read as an expression, an
+ * unclosed code span inside a table cell.
+ *
+ * Why this exists: `check:docs` and `check:docs-fresh` read the pages as
+ * text, so a page that MDX cannot compile passed both and only failed in the
+ * "Deploy Documentation" run after the push to beta (docs/components/
+ * cn-actions-bar.md and cn-workspace-filter-widget.md, 11 Oct 2026). The full
+ * `docusaurus build` takes minutes; this compiles the same pages in seconds.
+ *
+ * Needs the docusaurus/ dependencies (`cd docusaurus && npm ci`), which every
+ * code-quality check leg already installs.
+ *
+ * Usage: node scripts/check-docs-mdx.mjs
+ */
+
+import fs from 'node:fs'
+import { createRequire } from 'node:module'
+import path from 'node:path'
+import { fileURLToPath, pathToFileURL } from 'node:url'
+
+const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..')
+const DOCS_DIR = path.join(ROOT, 'docs')
+const SITE_REQUIRE = createRequire(path.join(ROOT, 'docusaurus', 'package.json'))
+
+/**
+ * Imports an ESM package from docusaurus/node_modules.
+ *
+ * @param {string} name package name
+ * @return {Promise<object>} the module namespace
+ */
+async function importFromSite(name) {
+	let resolved
+	try {
+		resolved = SITE_REQUIRE.resolve(name)
+	} catch {
+		console.error(`check:docs-mdx: cannot resolve ${name} from docusaurus/. Run \`cd docusaurus && npm ci\` first.`)
+		process.exit(2)
+	}
+	return import(pathToFileURL(resolved).href)
+}
+
+/**
+ * @param {string} dir directory to walk
+ * @return {string[]} every .md / .mdx file below it
+ */
+function listPages(dir) {
+	const out = []
+	for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
+		const full = path.join(dir, entry.name)
+		if (entry.isDirectory()) {
+			out.push(...listPages(full))
+		} else if (/\.mdx?$/.test(entry.name)) {
+			out.push(full)
+		}
+	}
+	return out
+}
+
+const { compile } = await importFromSite('@mdx-js/mdx')
+const remarkFrontmatter = (await importFromSite('remark-frontmatter')).default
+const remarkComment = (await importFromSite('@slorber/remark-comment')).default
+const remarkGfm = (await importFromSite('remark-gfm')).default
+const remarkDirective = (await importFromSite('remark-directive')).default
+const { unwrapMdxCodeBlocks, escapeMarkdownHeadingIds } = SITE_REQUIRE('@docusaurus/utils')
+
+// The syntax extensions the site's MDX processor parses with
+// (@docusaurus/mdx-loader lib/processor.js, mdx1Compat defaults on): front
+// matter, HTML comments, GFM tables, admonition directives. A parse error is
+// what breaks the build, so these are the ones that matter here.
+const REMARK_PLUGINS = [remarkFrontmatter, remarkComment, remarkGfm, remarkDirective]
+
+/**
+ * Applies the string preprocessing @docusaurus/mdx-loader runs before MDX
+ * (lib/preprocessor.js): unwrap mdx-code-block fences and escape custom
+ * heading ids.
+ *
+ * @param {string} source page source
+ * @return {string} the source MDX actually sees
+ */
+function preprocess(source) {
+	return escapeMarkdownHeadingIds(unwrapMdxCodeBlocks(source))
+}
+
+const pages = listPages(DOCS_DIR)
+const failures = []
+for (const page of pages) {
+	const source = preprocess(fs.readFileSync(page, 'utf8'))
+	try {
+		await compile(source, { remarkPlugins: REMARK_PLUGINS })
+	} catch (error) {
+		const where = error.line ? `:${error.line}:${error.column ?? 1}` : ''
+		failures.push(`${path.relative(ROOT, page)}${where}  ${error.reason ?? error.message}`)
+	}
+}
+
+if (failures.length > 0) {
+	console.error(`check:docs-mdx: ${failures.length} of ${pages.length} page(s) do not compile as MDX:\n`)
+	for (const line of failures) {
+		console.error(`  ${line}`)
+	}
+	console.error('\nEscape a literal `<word>` or `{` with a backslash, or put it in a code span.')
+	process.exit(1)
+}
+
+console.log(`check:docs-mdx: all ${pages.length} pages compile as MDX.`)

package/src/components/CnActionButtons/CnActionButtons.vue

@@ -175,6 +175,8 @@
 			:register="formRegister"
 			:initialData="formInitialValues || {}"
 			:dialogTitle="tr(formEntry.formTitle) || ''"
+			:eyebrow="tr(formEntry.formEyebrow) || ''"
+			:subtitle="tr(formEntry.formSubtitle) || ''"
 			:includeFields="formEntry.includeFields || null"
 			:excludeFields="formEntry.excludeFields || []"
 			:fieldOverrides="formEntry.fieldOverrides || {}"

package/src/components/CnActionsBar/CnActionsBar.md

@@ -222,3 +222,7 @@ Controlling the inline action button count — `inlineActionCount` sets how many
 `showBuildiqButton` is documented in the prop table of the component reference (board look, screens-chrome-parity).
 
 Slot `actions-end`: custom buttons after the primary Add button (CnIndexPage's saved views). Under the board look it renders in row 1, after the quick-filter chips.
+
+### Disabled view segments
+
+Under the board look `disabledViewModes` (an array of modes) draws view switch segments the page cannot open, in the fixed order table, cards, board, map, disabled and titled "<mode>: not available on this list". A mode that is also offered renders once, enabled. `CnIndexPage` fills it from `config.viewSwitch`.

package/src/components/CnActionsBar/CnActionsBar.vue

@@ -23,7 +23,7 @@
 				wrap together to the start of the next line (the DqZaken board),
 				never the switch alone.
 			-->
-			<div v-if="showSidebarToggle || (showViewToggle && viewSegments.length > 1)"
+			<div v-if="showSidebarToggle || $slots['filter-menu'] || (showViewToggle && viewSegments.length > 1)"
 				class="cn-actions-bar__view-controls"
 				data-testid="cn-actions-bar-view-controls">
 				<NcButton v-if="showSidebarToggle"
@@ -42,27 +42,35 @@
 						data-testid="cn-actions-bar-filter-badge"
 						:aria-label="filterCountLabel">{{ filterCount }}</span>
 				</NcButton>
+				<!--
+					@slot filter-menu
+					@description Board look, row 1: the Filter button drawn as a menu, for a page with no filter sidebar (`filterMenu`). Ignored while the sidebar toggle is shown.
+				-->
+				<slot v-else name="filter-menu" />
 				<div v-if="showViewToggle && viewSegments.length > 1"
 					class="cn-actions-bar__view-toggle"
 					role="group"
-					:aria-label="t('nextcloud-vue', 'View')">
+					:aria-label="t('nextcloud-vue', 'View mode')">
+					<!-- A segment the page cannot open (`disabledViewModes`) is drawn, as the board does, but disabled and named so. -->
 					<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 }"
+						:class="{ 'cn-actions-bar__view-toggle-btn--active': viewMode === seg.mode, 'cn-actions-bar__view-toggle-btn--disabled': seg.disabled }"
 						:aria-pressed="viewMode === seg.mode"
 						:aria-label="seg.label"
-						:title="seg.label"
-						@click="$emit('view-mode-change', seg.mode)">
+						:title="seg.disabled ? unavailableViewLabel(seg.label) : seg.label"
+						:disabled="seg.disabled"
+						:data-mode="seg.mode"
+						@click="seg.disabled || $emit('view-mode-change', seg.mode)">
 						<CnIcon v-if="seg.icon"
 							:name="seg.icon"
-							:size="24"
+							:size="18"
 							class="cn-actions-bar__view-toggle-icon" />
-						<component :is="seg.fallback"
+						<component :is="seg.boardFallback || seg.fallback"
 							v-else
-							:size="24"
+							:size="18"
 							class="cn-actions-bar__view-toggle-icon" />
 					</button>
 				</div>
@@ -527,6 +535,7 @@ import CalendarMonthOutline from 'vue-material-design-icons/CalendarMonthOutline
 import Close from 'vue-material-design-icons/Close.vue'
 import ContentCopy from 'vue-material-design-icons/ContentCopy.vue'
 import Export from 'vue-material-design-icons/Export.vue'
+import FormatListBulleted from 'vue-material-design-icons/FormatListBulleted.vue'
 import FormatListBulletedSquare from 'vue-material-design-icons/FormatListBulletedSquare.vue'
 import Import from 'vue-material-design-icons/Import.vue'
 import Magnify from 'vue-material-design-icons/Magnify.vue'
@@ -585,6 +594,7 @@ export default {
 		Tune,
 		ViewColumnOutline,
 		ViewGridOutline,
+		FormatListBulleted,
 		FormatListBulletedSquare,
 		CalendarMonthOutline,
 		MapMarkerOutline,
@@ -634,6 +644,19 @@ export default {
 			default: () => [],
 		},
 
+		/**
+		 * Board look: view modes the switch draws although the page cannot
+		 * open them, as disabled segments (the boards always draw table, cards,
+		 * board and map). Ignored without the board look.
+		 *
+		 * @type {Array<string>}
+		 * @spec openspec/changes/screens-view-switch-parity/specs/view-switch-board-look/spec.md#requirement-the-manifest-can-draw-segments-the-page-cannot-open
+		 */
+		disabledViewModes: {
+			type: Array,
+			default: () => [],
+		},
+
 		/**
 		 * The number on the Filter button's badge. Empty (`null`) counts the
 		 * `activeFilterChips`.
@@ -1165,11 +1188,15 @@ export default {
 				// only when the page offers it. A mode the board switch does not
 				// name (list, calendar) follows, so it is never lost.
 				defs.board = { label: t('nextcloud-vue', 'Board'), icon: '', fallback: ViewColumnOutline }
+				// The board's list icon: plain bullets, not the boxed ones.
+				defs.table.boardFallback = FormatListBulleted
+				const disabled = (this.disabledViewModes || []).filter((mode) => !modes.includes(mode))
+				const all = [...modes, ...disabled]
 				const fixed = ['table', 'cards', 'board', 'map']
-				const rest = modes.filter((mode) => !fixed.includes(mode))
-				return [...fixed.filter((mode) => modes.includes(mode)), ...rest]
+				const rest = all.filter((mode) => !fixed.includes(mode))
+				return [...fixed.filter((mode) => all.includes(mode)), ...rest]
 					.filter((mode) => defs[mode])
-					.map((mode) => ({ mode, ...defs[mode] }))
+					.map((mode) => ({ mode, ...defs[mode], disabled: disabled.includes(mode) }))
 			}
 			return modes
 				.filter((mode) => defs[mode])
@@ -1228,6 +1255,16 @@ export default {
 	},
 
 	methods: {
+		/**
+		 * The tooltip of a segment the page cannot open.
+		 *
+		 * @param {string} label The segment's name.
+		 * @return {string} "Map: not available on this list".
+		 */
+		unavailableViewLabel(label) {
+			return t('nextcloud-vue', '{view}: not available on this list', { view: label })
+		},
+
 		/**
 		 * The accessible name of a filter chip's remove button.
 		 *

package/src/components/CnAppRoot/CnAppRoot.md

@@ -84,7 +84,8 @@ With loading state, custom components, translate, permissions, and custom page t
 | `notificationLabels` | Object | No | `{}` | Labels for the app's notification rules in the user-settings notification pane, keyed `<schema>.<key>` or `<key>`; values are translated strings or `{ nl, en }` maps. A rule without a label reads as its key split into words ("Case assigned"), never as the raw key. Provided to descendants as `cnNotificationLabels` |
 | `permissions` | Array | No | `[]` | Permission strings for the current user; forwarded to `CnAppNav` for menu filtering |
 | `pageTypes` | Object | No | `null` | Page-type registry map (`type → component`). Falls back to the library's `defaultPageTypes`. Extend with `{ ...defaultPageTypes, report: MyReportPage }` |
-| `userSettingsTitle` | String | No | `''` | Title shown at the top of the hosted `NcAppSettingsDialog`. Empty (the default) resolves to `translate('User settings')`. Override per app to brand the modal (e.g. `'Decidiq preferences'`). |
+| `userSettingsTitle` | String | No | `''` | Title shown at the top of the hosted `NcAppSettingsDialog`. Empty (the default) resolves to "User settings" from the library catalogue ("Persoonlijke instellingen" in Dutch), then the app's `translate`. Override per app to brand the modal (e.g. `'Decidiq preferences'`). |
+| `userSettingsSections` | Array | No | `null` | The user-settings sections to draw, in order: `app` (the app's slot content), `notifications`, `credentials`, `walkthrough`, `integrations`. A key left out is not drawn. `null` keeps the defaults: every section after `#user-settings-sections` content, or only the `#user-settings` content and the integrations section. |
 | `adminSettingsTitle` | String | No | `''` | Title shown at the top of the admin-settings `NcAppSettingsDialog`. Empty (the default) resolves to `translate('Administration')`. Override per app (e.g. `'Pipelinq administration'`). |
 | `requiresApps` | Array | No | `['openregister']` | App ids that MUST be installed for the host app to function. Checked against the OCS capabilities API on mount. When any required app is missing, CnAppRoot renders the empty state from the `or-missing` slot (default: `<NcEmptyContent>`) instead of the renderer. Pass `[]` to opt out (e.g. launchpad, the docs/styleguide app) — useful for any consumer that does not depend on OpenRegister. |
 | `look` | String | No | `''` | The look the app is drawn in: `board` or `nextcloud`. Empty falls back to the manifest's top-level `look`, then `nextcloud`. Provided to descendants as `cnLook`. |
@@ -104,7 +105,8 @@ With loading state, custom components, translate, permissions, and custom page t
 | `header-actions` | — | Extra buttons rendered in the app header |
 | `sidebar` | — | Sidebar area rendered alongside `NcAppContent` |
 | `footer` | — | Footer area rendered inside `NcAppContent` |
-| `user-settings` | — | `NcAppSettingsSection` children rendered inside the host `NcAppSettingsDialog`. CnAppRoot always mounts the dialog and exposes `cnOpenUserSettings` via inject; CnAppNav binds it to manifest items declaring `action: "user-settings"`. Defaults to a single placeholder section. |
+| `user-settings-sections` | — | The app's own `NcAppSettingsSection` children, ADDED to the default sections (notifications, credentials, walkthrough replay, integrations). Place, order or hide the defaults with `userSettingsSections`. |
+| `user-settings` | — | The older slot: the app's own `NcAppSettingsSection` children, REPLACING the default sections (only this content and the integrations section are drawn, unless `userSettingsSections` names more). CnAppRoot always mounts the dialog and exposes `cnOpenUserSettings` via inject; CnAppNav binds it to manifest items declaring `action: "user-settings"`. |
 
 ## AI Chat Companion — Context push