@conduction/nextcloud-vue 2.80.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",
@@ -1368,7 +1369,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

@@ -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",
@@ -171,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",
@@ -1466,7 +1513,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.80.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/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
 

package/src/components/CnAppRoot/CnAppRoot.vue

@@ -31,10 +31,12 @@
 
   Hosts a per-user `NcAppSettingsDialog` that any descendant can open
   via the injected `cnOpenUserSettings()` method. CnAppNav binds the
-  inject to manifest entries with `action: "user-settings"`. Apps
-  populate the modal by passing `NcAppSettingsSection`s into the
-  `#user-settings` slot; the slot falls back to a single placeholder
-  section when no content is supplied.
+  inject to manifest entries with `action: "user-settings"`. The modal
+  draws the library's default sections (notifications, credentials,
+  walkthrough replay, integrations). Apps add their own
+  `NcAppSettingsSection`s through `#user-settings-sections` and place,
+  order or hide the defaults with the `userSettingsSections` prop. The
+  older `#user-settings` slot replaces the defaults instead.
 
   A SECOND, distinct `NcAppSettingsDialog` hosts admin-only, app-level
   (not per-user) settings, driven GENERICALLY by `manifest.adminSettings[]`
@@ -534,18 +536,33 @@
 			  User-settings modal. Always mounted so descendants can
 			  open it via the `cnOpenUserSettings` inject (CnAppNav
 			  wires this to manifest entries with
-			  `action: "user-settings"`). The `#user-settings` slot
-			  hosts NcAppSettingsSection children; the placeholder
-			  fallback below renders when no slot content is supplied.
+			  `action: "user-settings"`).
+
+			  The dialog draws its sections in the order
+			  `userSettingsSectionOrder()` returns: `app` (the app's own
+			  sections from the slots), `notifications`, `credentials`,
+			  `walkthrough` and `integrations`. A key that is left out is
+			  not drawn. Two slots carry the app's sections:
+			  - `#user-settings-sections` adds them: the library's default
+			    sections stay unless `userSettingsSections` leaves them out.
+			  - `#user-settings` (the original slot) replaces the defaults,
+			    as it always did: only the app's content and the
+			    integrations section are drawn, unless `userSettingsSections`
+			    names more.
 			-->
 			<NcAppSettingsDialog
 				:open="userSettingsOpen"
 				:showNavigation="true"
 				:name="resolvedUserSettingsTitle"
 				@update:open="userSettingsOpen = $event">
-				<!-- @slot user-settings Sections rendered inside the host NcAppSettingsDialog. Pass NcAppSettingsSection children. Defaults to the notification-preferences pane when omitted. -->
-				<slot name="user-settings">
-					<CnNotificationPreferences v-if="userSettingsOpen" />
+				<template v-for="section in userSettingsSectionOrder()" :key="section">
+					<template v-if="section === 'app'">
+						<!-- @slot user-settings The app's own sections (NcAppSettingsSection children), REPLACING the library's default sections: filling it draws only this content and the integrations section, unless the `userSettingsSections` prop names more. Prefer `#user-settings-sections`. -->
+						<slot name="user-settings" />
+						<!-- @slot user-settings-sections The app's own sections (NcAppSettingsSection children), ADDED to the library's default sections (notifications, credentials, walkthrough, integrations). Place, order or hide the defaults with the `userSettingsSections` prop. -->
+						<slot name="user-settings-sections" />
+					</template>
+					<CnNotificationPreferences v-else-if="section === 'notifications' && userSettingsOpen" />
 					<!--
 						Credential broker (OpenRegister). Lets the user manage the
 						secrets OR holds on their behalf; apps call external providers
@@ -553,9 +570,9 @@
 						`credentials[]` declarations drive the informational "Apps
 						requesting credentials" list.
 					-->
-					<NcAppSettingsSection v-if="userSettingsOpen"
+					<NcAppSettingsSection v-else-if="section === 'credentials' && userSettingsOpen"
 						id="credentials"
-						:name="translate('Credentials')">
+						:name="libraryCopy('Credentials')">
 						<CnCredentials
 							scope="personal"
 							:appId="appId"
@@ -567,7 +584,7 @@
 						when the manifest declares an enabled tour, so apps
 						without a walkthrough never show an empty section.
 					-->
-					<NcAppSettingsSection v-if="walkthroughEnabled"
+					<NcAppSettingsSection v-else-if="section === 'walkthrough' && walkthroughEnabled"
 						id="cn-walkthrough"
 						:name="restartWalkthroughSectionName">
 						<p class="cn-app-root__walkthrough-hint">
@@ -595,48 +612,47 @@
 							</NcButton>
 						</div>
 					</NcAppSettingsSection>
-				</slot>
-				<!--
-					Integrations (ADR-110) — the links that leave this app for
-					another one, gathered out of the navigation into one place.
-
-					DELIBERATELY OUTSIDE the #user-settings slot. Six fleet apps
-					override that slot, and anything placed inside the default
-					fallback disappears the moment an app supplies its own
-					content — silently, because an unmatched slot renders nothing
-					and reports nothing. A contract every app is supposed to
-					honour cannot live somewhere six apps switch off by accident.
-
-					Renders nothing when the app declares no integration
-					entries, so apps without any never show an empty section.
-				-->
-				<NcAppSettingsSection v-if="userSettingsOpen && integrationEntries.length"
-					id="cn-integrations"
-					:name="translate('Integrations')">
-					<p class="cn-app-root__integrations-hint">
-						{{ translate('These open in another app.') }}
-					</p>
-					<ul class="cn-app-root__integrations">
-						<li v-for="entry in integrationEntries" :key="entry.id">
-							<!--
-								One uniform external-link icon rather than the
-								entry's own: every row here goes to a different
-								app, which is the thing worth signalling, and
-								CnIcon falls back to a question mark for any
-								name an app has not registered — a broken-looking
-								glyph on a link that works fine.
-							-->
-							<NcButton variant="tertiary"
-								:href="entry.href"
-								:aria-label="entry.label">
-								<template #icon>
-									<OpenInNew :size="20" />
-								</template>
-								{{ entry.label }}
-							</NcButton>
-						</li>
-					</ul>
-				</NcAppSettingsSection>
+					<!--
+						Integrations (ADR-110): the links that leave this app for
+						another one, gathered out of the navigation into one place.
+
+						Drawn whether or not the app fills `#user-settings`: six
+						fleet apps fill that slot, and a section placed inside its
+						fallback disappeared for all of them in silence. Only an
+						explicit `userSettingsSections` without `integrations`
+						hides it, for an app whose board does not draw it.
+
+						Renders nothing when the app declares no integration
+						entries, so apps without any never show an empty section.
+					-->
+					<NcAppSettingsSection v-else-if="section === 'integrations' && userSettingsOpen && integrationEntries.length"
+						id="cn-integrations"
+						:name="translate('Integrations')">
+						<p class="cn-app-root__integrations-hint">
+							{{ libraryCopy('These open in another app.') }}
+						</p>
+						<ul class="cn-app-root__integrations">
+							<li v-for="entry in integrationEntries" :key="entry.id">
+								<!--
+									One uniform external-link icon rather than the
+									entry's own: every row here goes to a different
+									app, which is the thing worth signalling, and
+									CnIcon falls back to a question mark for any
+									name an app has not registered, a broken-looking
+									glyph on a link that works fine.
+								-->
+								<NcButton variant="tertiary"
+									:href="entry.href"
+									:aria-label="entry.label">
+									<template #icon>
+										<OpenInNew :size="20" />
+									</template>
+									{{ entry.label }}
+								</NcButton>
+							</li>
+						</ul>
+					</NcAppSettingsSection>
+				</template>
 			</NcAppSettingsDialog>
 
 			<!--
@@ -781,6 +797,12 @@ const KNOWN_REGISTRY_KINDS = Object.keys(REGISTRY_KIND_REQUIRED_FIELDS)
  */
 const OR_STORE_LINK = '/index.php/settings/apps/integration/openregister'
 
+/**
+ * The sections of the user-settings modal, in their default order. `app`
+ * stands for the app's own slot content.
+ */
+const USER_SETTINGS_SECTIONS = ['app', 'notifications', 'credentials', 'walkthrough', 'integrations']
+
 export default {
 	name: 'CnAppRoot',
 
@@ -1625,6 +1647,28 @@ export default {
 			default: '',
 		},
 
+		/**
+		 * The sections of the user-settings modal, in the order they are
+		 * drawn. Keys: `app` (the content of the `#user-settings-sections`
+		 * and `#user-settings` slots), `notifications`, `credentials`,
+		 * `walkthrough` and `integrations`. A key that is left out is not
+		 * drawn, so `['app', 'credentials', 'walkthrough']` hides the
+		 * notifications pane and the integrations section. Unknown keys are
+		 * ignored. The app's slot content is always drawn: without `app` in
+		 * the list it comes first.
+		 *
+		 * `null` (the default) keeps what each slot always did: all
+		 * defaults after the `#user-settings-sections` content, or only the
+		 * `#user-settings` content and the integrations section when an app
+		 * fills that older slot.
+		 *
+		 * @type {Array<string>|null}
+		 */
+		userSettingsSections: {
+			type: Array,
+			default: null,
+		},
+
 		/**
 		 * Title rendered at the top of the admin-settings modal
 		 * (NcAppSettingsDialog `name` prop). Defaults to the
@@ -3017,7 +3061,7 @@ export default {
 		},
 
 		resolvedUserSettingsTitle() {
-			return this.userSettingsTitle || this.translate('User settings')
+			return this.userSettingsTitle || this.libraryCopy('User settings')
 		},
 
 		/**
@@ -3036,7 +3080,7 @@ export default {
 		 * @return {string}
 		 */
 		restartWalkthroughSectionName() {
-			return this.translate('Walkthrough')
+			return this.libraryCopy('Walkthrough')
 		},
 
 		/**
@@ -3045,7 +3089,7 @@ export default {
 		 * @return {string}
 		 */
 		restartWalkthroughHint() {
-			return this.translate('Take the guided tour of this app again.')
+			return this.libraryCopy('Take the guided tour of this app again.')
 		},
 
 		/**
@@ -3054,7 +3098,7 @@ export default {
 		 * @return {string}
 		 */
 		restartWalkthroughLabel() {
-			return this.translate('Restart walkthrough')
+			return this.libraryCopy('Restart walkthrough')
 		},
 
 		/**
@@ -3389,6 +3433,54 @@ export default {
 			return legacy || null
 		},
 
+		/**
+		 * The keys of the user-settings sections to draw, in order. A method
+		 * rather than a computed, because which slots an app fills is read
+		 * from `$slots`, which a computed does not track.
+		 *
+		 * @return {Array<string>} Keys out of `USER_SETTINGS_SECTIONS`.
+		 * @spec openspec/changes/user-settings-sections/specs/user-settings-sections/spec.md#requirement-the-user-settings-dialog-keeps-its-default-sections-next-to-the-apps-own
+		 */
+		userSettingsSectionOrder() {
+			const replaces = Boolean(this.$slots['user-settings'])
+			const adds = Boolean(this.$slots['user-settings-sections'])
+			let order
+			if (Array.isArray(this.userSettingsSections)) {
+				order = [...new Set(this.userSettingsSections.filter((key) => USER_SETTINGS_SECTIONS.includes(key)))]
+			} else if (replaces) {
+				order = ['app', 'integrations']
+			} else {
+				order = [...USER_SETTINGS_SECTIONS]
+			}
+			if ((replaces || adds) && !order.includes('app')) {
+				order.unshift('app')
+			}
+			return order
+		},
+
+		/**
+		 * Copy for a part of the user settings dialog the library draws itself
+		 * (its title, the credentials and walkthrough sections). The library's
+		 * own catalogue answers first, because the app's catalogue may give
+		 * the same English word another meaning: learniq translates
+		 * "Credentials" as "Diploma's" for its own records, and the dialog
+		 * showed that above the vault pane. Only when the library has no
+		 * translation in the user's language does the host `translate` get a
+		 * turn, then the text as written.
+		 *
+		 * @param {string} key The English source string.
+		 * @return {string} The translated copy.
+		 * @spec openspec/changes/dutch-user-settings-dialog/specs/dutch-user-settings-dialog/spec.md#requirement-the-user-settings-dialog-reads-dutch-for-a-dutch-reader
+		 */
+		libraryCopy(key) {
+			const own = t('nextcloud-vue', key)
+			if (typeof own === 'string' && own !== '' && own !== key) {
+				return own
+			}
+			const host = this.translate(key)
+			return typeof host === 'string' && host !== '' ? host : key
+		},
+
 		/**
 		 * Return the translated copy for `key`, or `fallback` when the
 		 * `translate` prop leaves the key unchanged (its default is the