@conduction/nextcloud-vue 2.56.0-beta.30 → 2.56.0-beta.31

package/dist/nextcloud-vue.cjs.js.map

@@ -1,4 +1,4 @@
 [diffend] Oversized file quarantined before diffing.
 name: package/dist/nextcloud-vue.cjs.js.map
-size: 39172953 bytes
-sha256: ef1ebbbf9606b2cbad5aed35a9ed0121763f6eda57474125658a81f7be30dd26
+size: 39419324 bytes
+sha256: 8beaa575ec5a98f9b2ce3a89b8750a62dbb3e8150408a1753a96b7a821b9e195

package/dist/nextcloud-vue.css

@@ -1530,7 +1530,8 @@
 }
 
 /* Filter: a labelled secondary button, 36px, radius 8, with the active count. */
-.cn-look-board .cn-actions-bar__filter-button.button-vue {
+.cn-look-board .cn-actions-bar__filter-button.button-vue,
+.cn-look-board .cn-actions-bar__filter-menu .button-vue {
 	min-height: 36px;
 	height: 36px;
 	border-radius: 8px;
@@ -1780,11 +1781,16 @@
 	max-width: calc(100% - 26px);
 }
 
-/* The selection column: 28px, 18px checkboxes. */
+/* The selection column: 18px checkboxes, 28px of content after 16px of padding.
+   The box model is set with `!important` and the widths include the padding:
+   Nextcloud's server.css sets `box-sizing: border-box` on everything under
+   `#content[class*="app-"]`, an id selector no class rule outranks, so a plain
+   `content-box` here was ignored and the cell left 12px for the checkbox (the
+   header's checkbox showed as a stray bracket). */
 .cn-look-board .cn-table-container--board .cn-data-table .cn-table-col--checkbox {
-	box-sizing: content-box;
-	width: 28px;
-	min-width: 28px;
+	box-sizing: border-box !important;
+	width: 44px;
+	min-width: 44px;
 	padding-inline: 16px 0;
 	text-align: start;
 }
@@ -1842,10 +1848,12 @@
 	line-height: 1.4;
 }
 
-/* The row menu column holds one 34px button. */
+/* The row menu column holds one 34px button between 16px of padding, so 66px
+   border to border (see the selection column for why the box model is forced). */
 .cn-look-board .cn-table-container--board .cn-data-table .cn-table-col--actions {
-	width: 34px;
-	min-width: 0;
+	box-sizing: border-box !important;
+	width: 66px;
+	min-width: 66px;
 	padding-inline: 16px;
 	text-align: end;
 }
@@ -15273,6 +15281,70 @@ button.cn-files-card__open[data-v-46f7e3c9]:hover {
 	white-space: nowrap;
 	color: var(--color-text-maxcontrast);
 }
+.cn-files-browser__col-select[data-v-f5bdd9e2] {
+	width: 36px;
+	text-align: center;
+}
+.cn-files-browser__select[data-v-f5bdd9e2] {
+	width: 18px;
+	height: 18px;
+	margin: 0;
+	accent-color: var(--color-primary-element);
+}
+.cn-files-browser__bulk-bar[data-v-f5bdd9e2] {
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	gap: 8px;
+	padding: 8px 12px;
+	border-radius: var(--border-radius-large);
+	background: var(--color-primary-element-light);
+}
+.cn-files-browser__bulk-count[data-v-f5bdd9e2] {
+	font-weight: 600;
+	margin-inline-end: 8px;
+}
+.cn-files-browser__facets[data-v-f5bdd9e2] {
+	display: flex;
+	flex-wrap: wrap;
+	align-items: center;
+	gap: 8px 16px;
+}
+.cn-files-browser__facet[data-v-f5bdd9e2] {
+	display: flex;
+	flex-wrap: wrap;
+	gap: 6px;
+}
+.cn-files-browser__facet-chip[data-v-f5bdd9e2] {
+	display: inline-flex;
+	align-items: center;
+	gap: 6px;
+	min-height: 32px;
+	padding: 0 12px;
+	border: 1px solid var(--color-border-dark);
+	border-radius: var(--border-radius-pill);
+	background: var(--color-main-background);
+	color: var(--color-main-text);
+	cursor: pointer;
+}
+.cn-files-browser__facet-chip--active[data-v-f5bdd9e2] {
+	border-color: var(--color-primary-element);
+	background: var(--color-primary-element-light);
+}
+.cn-files-browser__group-heading[data-v-f5bdd9e2] {
+	padding: 12px 8px 4px;
+	text-align: start;
+	font-weight: 700;
+}
+.cn-files-browser__group-count[data-v-f5bdd9e2] {
+	margin-inline-start: 6px;
+	font-weight: 400;
+	color: var(--color-text-maxcontrast);
+}
+.cn-files-browser__no-match[data-v-f5bdd9e2] {
+	padding: 16px 8px;
+	color: var(--color-text-maxcontrast);
+}
 .cn-files-browser__col-actions[data-v-f5bdd9e2] {
 	width: 48px;
 }
@@ -21928,6 +22000,59 @@ a.cn-kpi-card--board * {
 	gap: var(--cn-kpi-stack-gap, 12px);
 }
 
+/* Rows layout: the board's "label left, number right" card body. */
+.cn-stats-block-widget--rows[data-v-4f8583ef] {
+	display: flex;
+	flex-direction: column;
+	gap: 12px;
+	box-sizing: border-box;
+	padding: 20px 22px;
+}
+.cn-stats-block-widget__rows-title[data-v-4f8583ef] {
+	margin: 0;
+	font-size: 15px;
+	font-weight: 600;
+	color: var(--color-text-maxcontrast);
+}
+.cn-stats-block-widget__rows[data-v-4f8583ef] {
+	display: flex;
+	flex-direction: column;
+	gap: 8px;
+	margin: 0;
+	font-size: 14px;
+}
+.cn-stats-block-widget__row[data-v-4f8583ef] {
+	display: flex;
+	align-items: baseline;
+	justify-content: space-between;
+	gap: 16px;
+}
+.cn-stats-block-widget__row-label[data-v-4f8583ef] {
+	min-width: 0;
+	margin: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+}
+.cn-stats-block-widget__row-value[data-v-4f8583ef] {
+	flex: none;
+	margin: 0;
+	font-size: 17px;
+	font-weight: 700;
+	text-align: right;
+}
+.cn-stats-block-widget__row-value--success[data-v-4f8583ef] {
+	color: var(--color-text-success, var(--color-success-text));
+}
+.cn-stats-block-widget__row-value--warning[data-v-4f8583ef] {
+	color: var(--color-text-warning, var(--color-warning-text));
+}
+.cn-stats-block-widget__row-value--error[data-v-4f8583ef] {
+	color: var(--color-text-error, var(--color-error-text));
+}
+.cn-stats-block-widget__row-value--primary[data-v-4f8583ef] {
+	color: var(--color-primary-element);
+}
+
 
 .cn-stats-block-form[data-v-20f3b26f] {
 	display: flex;
@@ -22529,6 +22654,28 @@ to { background-position: -200% 0;
 	margin: 0;
 	color: var(--color-text-maxcontrast);
 }
+
+/* Stacked (PqMijnWerk "Begin hier"): the text, then the action under it. */
+.cn-banner-widget--stacked[data-v-3531692f] {
+	flex-direction: column;
+	align-items: flex-start;
+	gap: 10px;
+}
+.cn-banner-widget--stacked .cn-banner-widget__body[data-v-3531692f] {
+	flex: 0 0 auto;
+	gap: 10px;
+}
+.cn-banner-widget--stacked .cn-banner-widget__title[data-v-3531692f] {
+	font-size: 16px;
+	line-height: 1.4;
+}
+.cn-banner-widget--stacked .cn-banner-widget__reason[data-v-3531692f] {
+	font-size: 14px;
+}
+.cn-banner-widget--stacked .cn-banner-widget__action[data-v-3531692f] {
+	min-height: var(--cn-board-control-height, 40px);
+	font-size: 14px;
+}
 .cn-banner-widget__actions[data-v-3531692f] {
 	display: flex;
 	flex-wrap: wrap;
@@ -23524,6 +23671,13 @@ button.cn-stepper__step[data-v-19697746] {
 }
 
 
+.cn-form-page__honeypot {
+	position: absolute;
+	left: -10000px;
+	width: 1px;
+	height: 1px;
+	overflow: hidden;
+}
 .cn-form-page {
 	display: flex;
 	flex-direction: column;
@@ -28805,6 +28959,42 @@ a.cn-record-list__inline-title[data-v-7073b362] {
 	gap: 2px;
 }
 
+/* The chips: the compact segmented group, left, in the card the grid draws. */
+.cn-workspace-filter-widget--chips[data-v-f0d5c1c6] {
+	flex-direction: row;
+	flex-wrap: wrap;
+	align-items: center;
+}
+
+/* A bar: its controls in one row, an `align: "end"` control pushed right. */
+.cn-workspace-filter-widget--bar[data-v-f0d5c1c6] {
+	flex-direction: row;
+	flex-wrap: wrap;
+	align-items: center;
+	gap: 12px 16px;
+}
+
+/* An inline control sits in a bar: label left of the control, width to its content. */
+.cn-workspace-filter-widget--inline[data-v-f0d5c1c6] {
+	flex-direction: row;
+	align-items: center;
+	gap: 8px;
+	width: auto;
+}
+.cn-workspace-filter-widget--inline .cn-workspace-filter-widget__label[data-v-f0d5c1c6] {
+	font-weight: 400;
+	color: var(--color-text-maxcontrast);
+}
+.cn-workspace-filter-widget--end[data-v-f0d5c1c6] {
+	margin-inline-start: auto;
+}
+.cn-workspace-filter-widget--end ~ .cn-workspace-filter-widget--end[data-v-f0d5c1c6] {
+	margin-inline-start: 0;
+}
+.cn-workspace-filter-widget__toggle[data-v-f0d5c1c6] {
+	font-weight: 600;
+}
+
 /* The start card: text left, control (and link) right, as PqDashboard's "Contact starten". */
 .cn-workspace-filter-widget--start[data-v-f0d5c1c6] {
 	flex-direction: row;

package/l10n/en.json

@@ -1368,7 +1368,14 @@
     "{count} filters": "{count} filters",
     "{count} more filters": "{count} more filters",
     "{label} — show the other filters": "{label} — show the other filters",
-    "{view}: not available on this list": "{view}: not available on this list"
+    "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": [

package/l10n/nl.json

@@ -171,6 +171,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",
@@ -1466,7 +1512,14 @@
     "{count} days left": "Nog {count} dagen",
     "1 day overdue": "1 dag te laat",
     "{count} days overdue": "{count} dagen te laat",
-    "{view}: not available on this list": "{view}: niet beschikbaar in deze lijst"
+    "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": [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@conduction/nextcloud-vue",
-  "version": "2.56.0-beta.30",
+  "version": "2.56.0-beta.31",
   "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/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,6 +42,11 @@
 						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"

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