@conduction/nextcloud-vue 2.102.0 → 2.104.0

package/src/components/CnWidgetObjectTable/CnWidgetObjectTable.vue

@@ -368,6 +368,20 @@ export default {
 			default: 0,
 		},
 
+		/**
+		 * Rows per page: the board's pager under the table ("4 of 7", page
+		 * buttons, Next), forwarded to CnDataTable. It pages the rows the
+		 * widget holds; with a `source`, `source.limit` is how many are read
+		 * (OpenRegister's default page otherwise). 0 (the default) shows no
+		 * pager.
+		 *
+		 * @spec openspec/changes/object-table-pager/specs/object-table/spec.md#requirement-an-object-table-can-page-its-rows
+		 */
+		pageSize: {
+			type: Number,
+			default: 0,
+		},
+
 		/**
 		 * vue-router route object for the "View all" footer link. Forwarded
 		 * to CnDataTable (footer shows when the rows are a `limit`-ed subset).
@@ -611,7 +625,9 @@ export default {
 				params[`_order[${field}]`] = dir === 'desc' ? 'desc' : 'asc'
 			}
 			if (typeof src.limit === 'number' && src.limit > 0) {
-				params._limit = src.limit + 1
+				// Under a pager `limit` is how many rows the pages hold, not a
+				// "View all" cap that needs to see one more.
+				params._limit = this.pageSize > 0 ? src.limit : src.limit + 1
 			}
 			// `source.extend` (#91 Wave 3): forwarded as OR's repeated
 			// `_extend[]` param so virtual/declarative fields (e.g.
@@ -736,7 +752,7 @@ export default {
 				inner.register = this.source.register
 				inner.schemaId = this.source.schema
 				inner.fetchParams = this.resolvedFetchParams
-				if (typeof this.source.limit === 'number' && this.source.limit > 0) {
+				if (typeof this.source.limit === 'number' && this.source.limit > 0 && !(this.pageSize > 0)) {
 					inner.limit = this.source.limit
 				}
 			}

package/src/components/CnWizardDialog/CnWizardDialog.vue

@@ -5,7 +5,7 @@
 		defaultWidth="wizard"
 		:eyebrow="boardEyebrow"
 		:subtitle="subtitle"
-		:name="dialogTitle"
+		:name="shownTitle"
 		size="large"
 		:open="dialogOpen"
 		:noClose="loading || !cancellable"
@@ -265,6 +265,12 @@ export default {
 		 * Empty uses the dialog title.
 		 */
 		eyebrowContext: { type: String, default: '' },
+		/**
+		 * Board look: head the dialog with the current step's label, the
+		 * dialog title moving to the eyebrow's context. The result phase and
+		 * the Nextcloud look keep `dialogTitle`.
+		 */
+		stepHeading: { type: Boolean, default: false },
 		/**
 		 * The eyebrow sentence, with `{context}`, `{step}` and `{total}`
 		 * placeholders, so it can be translated.
@@ -356,6 +362,19 @@ export default {
 				.replace('{total}', String(this.steps.length))
 		},
 
+		/**
+		 * The dialog's heading: the current step's label with `stepHeading`
+		 * in the board look, otherwise `dialogTitle`.
+		 *
+		 * @return {string} The heading.
+		 */
+		shownTitle() {
+			if (this.stepHeading && this.isBoardLook && this.result === null && this.currentStep && this.currentStep.label) {
+				return this.currentStep.label
+			}
+			return this.dialogTitle
+		},
+
 		/** @return {object} The check icon, the default finishing icon. */
 		Check() {
 			return Check

package/src/components/index.js

@@ -130,6 +130,7 @@ export { default as CnContactsTab } from '../integrations/builtin/contacts/CnCon
 export { CnContactPicker } from './CnContactPicker/index.js'
 export { CnContactCreate } from './CnContactCreate/index.js'
 export { CnResourceSelect } from './CnResourceSelect/index.js'
+export { CnSearchSelect } from './CnSearchSelect/index.js'
 export { CnPropertySourceField } from './CnPropertySourceField/index.js'
 export { CnDurationField } from './CnDurationField/index.js'
 export { CnFavouriteToggle } from './CnFavouriteToggle/index.js'

package/src/composables/indexSources.js

@@ -14,7 +14,7 @@ import { formatRelativeDate } from '../utils/boardDate.js'
 import { fetchReferenceObjects } from '../utils/boardReferenceColumns.js'
 import { fillTemplate } from '../utils/fillTemplate.js'
 import { FLOW_RUN_ERROR_STATUSES, flowRunStatuses } from '../utils/flowRunStatus.js'
-import { fetchGroupMembers, fetchPresence, fetchStatuses } from '../utils/nextcloudDirectory.js'
+import { fetchGroupMembers, fetchPresence, fetchStatuses, fetchUsers } from '../utils/nextcloudDirectory.js'
 import { readPath } from '../utils/readPath.js'
 import { useFlowStore } from './useFlowStore.js'
 import { organisationRecord, useOrganisationStore } from './useOrganisationStore.js'
@@ -1054,7 +1054,8 @@ function searchSource(config = {}, context = {}) {
  * DqAfdelingen). Pair it with `folderSidebar: { source: 'groups',
  * filterField: 'group' }`, which lists the groups as the folder tree; the
  * selected group arrives as `group`. `sourceConfig.group` is the group shown
- * before one is picked.
+ * before one is picked; without one, All lists every user the reader may
+ * list (all users for an admin, their groups' users for a sub-admin).
  *
  * Today is the dav app's out-of-office period when one runs now ("Absent
  * until 14 Oct"), else the user status (present, away) and its message. The
@@ -1088,14 +1089,13 @@ function usersSource() {
 		load: async (config) => {
 			const group = String((config && (config.group || config.defaultGroup)) || '')
 			const mine = ++seq
-			if (group === '') {
-				state.rows = []
-				return
-			}
 			state.loading = true
 			try {
 				const { default: axios } = await import('@nextcloud/axios')
-				const [members, statuses] = await Promise.all([fetchGroupMembers(axios, group), fetchStatuses(axios)])
+				const [members, statuses] = await Promise.all([
+					group === '' ? fetchUsers(axios, { limit: (config && config.limit) || 500 }) : fetchGroupMembers(axios, group),
+					fetchStatuses(axios),
+				])
 				const functionField = (config && config.functionField) || 'headline'
 				const rolesField = (config && config.rolesField) || 'role'
 				const rows = await Promise.all(members.map(async (user) => {

package/src/css/dialog.css

@@ -9,14 +9,16 @@
  * Theme hooks (all optional, defaults below):
  *   --cn-dialog-danger               fill of a destructive primary
  *   --cn-dialog-eyebrow-color        eyebrow colour
- *   --cn-dialog-eyebrow-transform    uppercase (default) or none
+ *   --cn-dialog-eyebrow-transform    none (default, sentence case) or uppercase
+ *   --cn-dialog-eyebrow-tracking     letter spacing; 0 by default, 0.06em suits capitals
  */
 
 .cn-dialog-board {
 	--cn-dialog-width: 640px;
 	--cn-dialog-danger: var(--color-error);
 	--cn-dialog-eyebrow-color: var(--color-primary-element-text, var(--color-main-text));
-	--cn-dialog-eyebrow-transform: uppercase;
+	--cn-dialog-eyebrow-transform: none;
+	--cn-dialog-eyebrow-tracking: 0;
 }
 
 /* Dimmed page behind the dialog: text colour at 45%. */
@@ -73,7 +75,7 @@
 	margin-bottom: 4px;
 	font-size: 13px;
 	font-weight: 700;
-	letter-spacing: 0.06em;
+	letter-spacing: var(--cn-dialog-eyebrow-tracking, 0.06em);
 	text-transform: var(--cn-dialog-eyebrow-transform, uppercase);
 	color: var(--cn-dialog-eyebrow-color, var(--color-main-text));
 }

package/src/css/index-page.css

@@ -190,6 +190,25 @@
 	font-size: 14px;
 }
 
+/* The selected folder's heading above the list. */
+.cn-index-page__scope-heading {
+	display: flex;
+	flex-direction: column;
+	gap: 4px;
+	margin-bottom: 12px;
+}
+
+.cn-index-page__scope-title {
+	margin: 0;
+	font-size: 1.25em;
+	font-weight: 700;
+}
+
+.cn-index-page__scope-subtitle {
+	font-size: 14px;
+	color: var(--color-text-maxcontrast);
+}
+
 /* Opt-in folder navigation pane (left of the list). */
 .cn-index-page__folder-pane {
 	flex: 0 0 240px;

package/src/css/look-board-index.css

@@ -372,6 +372,17 @@
 	cursor: not-allowed;
 }
 
+/* `searchPlacement: "toolbar"`: the search field on row 1 takes the room
+   before Filter and the view switch, which keep the end of the row. */
+.cn-look-board .cn-actions-bar--board > .cn-actions-bar__row--views > .cn-actions-bar__search--toolbar {
+	flex: 1 1 220px;
+	min-width: 180px;
+}
+
+.cn-look-board .cn-actions-bar--board > .cn-actions-bar__row--views > .cn-actions-bar__search--toolbar ~ .cn-actions-bar__view-controls {
+	margin-inline-start: 0;
+}
+
 /* The search field: 40px, radius 8, not a pill. */
 .cn-look-board .cn-actions-bar--board .cn-actions-bar__search {
 	flex: 1 1 260px;
@@ -1108,3 +1119,40 @@
 .cn-look-board:has(.cn-index-page) > .app-sidebar__toggle {
 	display: none;
 }
+
+/* The folder pane as a card (DqAfdelingen): 280px, a hairline border, 12px
+   corners, with each folder's count in a grey pill. */
+.cn-look-board .cn-index-page__folder-pane {
+	flex: 0 0 280px;
+	align-self: flex-start;
+	margin-inline-end: 20px;
+	padding: 14px;
+	border: 1px solid var(--cn-board-hairline);
+	border-radius: var(--cn-board-card-radius, 12px);
+	background: var(--color-main-background);
+}
+
+.cn-look-board .cn-index-page__folder-pane .cn-folder-tree__count {
+	display: inline-flex;
+	align-items: center;
+	justify-content: center;
+	min-width: 20px;
+	height: 20px;
+	padding: 0 6px;
+	box-sizing: border-box;
+	border-radius: 10px;
+	background: var(--color-background-dark);
+	color: var(--color-main-text);
+	font-size: 12px;
+	font-weight: 600;
+}
+
+/* The selected folder's heading above the list: a 20px title over a soft line. */
+.cn-look-board .cn-index-page__scope-heading {
+	margin-bottom: 16px;
+}
+
+.cn-look-board .cn-index-page__scope-title {
+	font-size: 20px;
+	font-weight: 700;
+}

package/src/index.js

@@ -279,6 +279,7 @@ export {
 	CnSaveViewDialog,
 	CnSchemaFormDialog,
 	CnSearchPage,
+	CnSearchSelect,
 	CnSectionsWidget,
 	CnSettingsCard,
 	CnSettingsField,

package/src/mixins/pageViews.js

@@ -270,12 +270,14 @@ export const pageViews = {
 
 		/**
 		 * Whether a user arranges the views for themselves (`userLayout`).
+		 * Not while Buildiq edits the page (`editingBody`): Buildiq is the
+		 * layout editor, and it shows and changes the manifest layout.
 		 *
 		 * @return {boolean}
 		 * @spec openspec/changes/page-view-user-layouts/specs/view-switch-containers/spec.md#requirement-a-user-arranges-each-view-for-themselves
 		 */
 		viewUserLayoutOn() {
-			return this.userLayout === true && this.hasViews
+			return this.userLayout === true && this.hasViews && this.editingBody !== true
 		},
 
 		/**
@@ -640,6 +642,11 @@ export const pageViews = {
 				this.viewUserLayouts = { ...this.viewUserLayouts, [view.id]: arranged }
 				this.viewUserLayoutsDirty = { ...this.viewUserLayoutsDirty, [view.id]: true }
 				this.$emit('view-layout-change', { view: view.id, layout: arranged })
+				// Outside an in-page edit session (the dashboard's edit mode, the
+				// detail page's Arrange) no Done will come to save it.
+				if (this.isEditing !== true && this.arrangingView !== true) {
+					this.saveViewUserLayouts()
+				}
 				return
 			}
 			for (const u of updated) {

package/src/schemas/app-manifest-v2.schema.json

@@ -3,7 +3,7 @@
 	"$id": "https://raw.githubusercontent.com/ConductionNL/nextcloud-vue/main/src/schemas/app-manifest-v2.schema.json",
 	"title": "Conduction App Manifest v2",
 	"description": "v2 schema for the JSON-driven page and navigation manifest consumed by @conduction/nextcloud-vue. Introduces a uniform widgets[] array on every page type with a per-slot grid coordinate system, a typed actions[] discriminator, and the required $schema field for version detection. v1 manifests continue to validate against app-manifest.schema.json (unchanged).",
-	"version": "2.125.0",
+	"version": "2.127.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -115,10 +115,11 @@
 								}
 							},
 							"optionsSource": { "type": "string", "description": "choice: where to read the option list from at runtime, instead of declaring it here. Names a key in the app's own GET /api/setup/status document (dots walk into nested objects, e.g. `profiles`). Entries accept `id` for `value` and `name` for `label`, and a numeric `objectCount` becomes the stat a card shows. Use it when the SERVER owns what is on offer, so the manifest cannot drift from it." },
-							"display": { "type": "string", "enum": ["select", "cards"], "default": "select", "description": "choice: how the options are rendered. `select` is a dropdown; `cards` is a grid of CnChoiceCards, which shows each option's description and stats. Pick cards when the choice needs explaining." },
+							"display": { "type": "string", "enum": ["select", "cards", "rows"], "default": "select", "description": "choice: how the options are rendered. `select` is a dropdown; `cards` is a grid of CnChoiceCards, which shows each option's description and stats; `rows` is CnChoiceCards' rows layout, one radio row per option with its description below the label. Pick cards or rows when the choice needs explaining." },
 							"dependsOn": { "type": "string", "description": "choice: the configKey of a previous choice step this one cascades from. Disabled until the parent is set; its option list is taken from optionsByParent[parentValue] (e.g. organisation-type depends on country)." },
 							"optionsByParent": { "type": "object", "description": "choice: map of parent-choice value → options[] for a dependent (dependsOn) choice. Same option item shape as `options`.", "additionalProperties": { "type": "array", "items": { "type": "object", "additionalProperties": false, "required": ["value", "label"], "properties": { "value": {}, "label": { "type": "string" } } } } },
 							"suggestFrom": { "type": "string", "description": "choice: the configKey of an earlier choice this step pre-fills a suggestion from. When that value is set and the user has not yet picked here, the option matching suggestMap[parentValue] is auto-selected (still user-overridable)." },
+							"default": { "description": "choice: the option value chosen when the step opens (an array of values with `multiple`). Not applied to a step the server already completed." },
 							"suggestMap": { "type": "object", "description": "choice: map of suggestFrom value → suggested option value. Used to auto-suggest a default (e.g. RGS template suggested from organisation type).", "additionalProperties": { "type": "string" } },
 							"multiple": { "type": "boolean", "default": false, "description": "choice: allow multi-select." },
 							"loadAction": { "type": "string", "minLength": 1, "description": "choice with display cards: an actionId each option card loads itself with. Every card except the one whose value is `none` gets its own Load button, which POSTs { dataset: <value> } to /api/setup/action/{loadAction}, spins while it runs and shows the result on that card. A successful load also selects the card. With loadAction the separate run-action step that loaded the picked dataset is no longer needed; manifests that keep it still work." },
@@ -541,6 +542,18 @@
 		}
 	},
 	"$defs": {
+		"fieldOverride": {
+			"type": "object",
+			"additionalProperties": true,
+			"description": "One field's overrides over its schema-derived descriptor (label, order, hidden, readOnly, widget, enumLabels and more stay free-form). A `widget` that is not one of the form's own widget names mounts the registered component of that name (the v2 registry, then customComponents). 2.126.0 documents the search look of a single select.",
+			"properties": {
+				"widget": { "type": "string", "minLength": 1 },
+				"look": { "type": "string", "enum": ["search"], "description": "`search` draws a single select as CnSearchSelect: a magnifier instead of the chevron, and rows with initials or an icon, the name, a secondary line and a check on the chosen one (DqOverdragen \"Nieuw team\")." },
+				"optionSecondary": { "type": "string", "description": "look 'search': the row's secondary line, a template filled from each option (\"{members} leden · {focus}\")." },
+				"optionAvatar": { "type": "boolean", "description": "look 'search': draw each option's initials." },
+				"optionIcon": { "type": "string", "minLength": 1, "description": "look 'search': one icon for every row." }
+			}
+		},
 		"breadcrumbCrumb": {
 			"type": "object",
 			"additionalProperties": false,
@@ -1985,6 +1998,7 @@
 										"items": { "$ref": "#/$defs/action" },
 										"description": "Declarative row/widget actions rendered by CnWidgetObjectTable. object-op patch/delete render per row; object-op create renders as a widget-scoped footer affordance."
 									},
+									"pageSize": { "type": "integer", "minimum": 1, "description": "Rows per page: the table shows one page with the board pager under it (\"4 of 7\", DqCatalogus). Under a pager `source.limit` is how many rows are read (2.127.0)." },
 									"rowClass": {
 										"type": "array",
 										"description": "#91: declarative per-row CSS class rules compiled into CnDataTable's rowClass function. Each rule { when: { field, op?, value }, class } adds `class` to a row when the shared visibleWhen predicate holds against that row (field = dot-path into the row, op = eq|neq|gt|gte|lt|lte default eq, value = literal). Rules evaluate in order and every matching class is space-joined — so overdue / at-risk rows can be highlighted from the manifest. A host-supplied rowClass FUNCTION (runtime-only) still passes straight through.",
@@ -2162,6 +2176,39 @@
 						}
 					}
 				},
+				{
+					"description": "record-list built-in widget (CnRecordListWidget): the action under the list, `props.content.footerAction` (2.126.0). Other content keys stay free-form.",
+					"if": {
+						"properties": { "widgetKey": { "const": "record-list" } },
+						"required": ["widgetKey"]
+					},
+					"then": {
+						"properties": {
+							"props": {
+								"type": "object",
+								"properties": {
+									"content": {
+										"type": "object",
+										"properties": {
+											"footerAction": {
+												"type": "object",
+												"additionalProperties": true,
+												"required": ["label"],
+												"description": "One action under the list, also under the empty text (DqBezwaar \"Beroep registreren\"). Its other keys are an action's (`type`, `route`, `form`, ...). While `disabledWhen` holds it is disabled and says `disabledReason` (\"Kan zodra de beslissing is verzonden\"). Label and reason go through the host's translate.",
+												"properties": {
+													"label": { "type": "string", "minLength": 1 },
+													"icon": { "type": "string", "minLength": 1 },
+													"disabledWhen": { "$ref": "#/$defs/visibleWhen" },
+													"disabledReason": { "type": "string" }
+												}
+											}
+										}
+									}
+								}
+							}
+						}
+					}
+				},
 				{
 					"description": "audit-trail built-in widget (CnAuditTrailWidget, Wave 1): the object change-log card. All props are optional — register/schema/objectId normally arrive via the detail-page object-context merge; explicit props win.",
 					"if": {
@@ -2864,7 +2911,7 @@
 				},
 				"fieldOverrides": {
 					"type": "object",
-					"additionalProperties": true,
+					"additionalProperties": { "$ref": "#/$defs/fieldOverride" },
 					"description": "open-form: per-field overrides passed to fieldsFromSchema, keyed by field. Recognised keys include label, order, hidden, readOnly and widget."
 				},
 				"advanced": {
@@ -3201,9 +3248,9 @@
 				},
 				"op": {
 					"type": "string",
-					"enum": ["eq", "neq", "gt", "gte", "lt", "lte", "empty", "notEmpty", "in"],
+					"enum": ["eq", "neq", "gt", "gte", "lt", "lte", "empty", "notEmpty", "in", "anyOf"],
 					"default": "eq",
-					"description": "Comparison operator (default eq). eq/neq compare loosely-normalised primitives; ordering operators coerce both sides to Number. `in` holds when the value is one of the listed `value` array (2.87.0). `empty` / `notEmpty` take no `value` and treat undefined, null, '' and an empty array alike — the one question eq cannot ask, because an unset field arrives in a shape that depends on the store and String(null) is the word 'null' rather than blank."
+					"description": "Comparison operator (default eq). eq/neq compare loosely-normalised primitives; ordering operators coerce both sides to Number. `in` holds when the value is one of the listed `value` array (2.87.0). `anyOf` holds when the value, or any entry of a list value, is one of the listed `value` array: a record whose `dataCategories` holds \"health\" among others matches `anyOf [\"health\", \"ethnicity\"]` (2.126.0). `empty` / `notEmpty` take no `value` and treat undefined, null, '' and an empty array alike — the one question eq cannot ask, because an unset field arrives in a shape that depends on the store and String(null) is the word 'null' rather than blank."
 				},
 				"value": {
 					"description": "The right-hand side of the comparison, resolved through the shared @-token grammar so `@me` names the signed-in reader rather than a literal only the server knows. Omitted for `empty` / `notEmpty`."
@@ -4006,6 +4053,9 @@
 							"additionalProperties": true,
 							"description": "type='index': the opt-in folder navigation pane (CnFolderSidebar) rendered left of the list. Selecting a folder filters the list by `filterField` (or `field`); \"All\" clears it. Only the per-scope list-layout keys are typed here; the pane's own keys (source, register, schema, idField, nameField, folders, allLabel, title, allowCreate, ...) stay free-form. Maps to CnIndexPage `folderSidebar`.",
 							"properties": {
+								"heading": { "type": "boolean", "description": "true heads the list with the selected folder's name, its parent folder and its count (always on a `groups` pane, 2.127.0)." },
+								"countText": { "type": "string", "minLength": 1, "description": "The count in that heading, `{count}` filled in, through the app's translate; a groups pane defaults to \"{count} members\" (2.127.0)." },
+								"pane": { "type": "boolean", "default": true, "description": "false keeps the folder scope (a deep link such as `?caseType=<uuid>` still applies the scope's look and filter) without drawing the pane (dossiq's simple profile, 2.126.0)." },
 								"folders": {
 									"type": "array",
 									"description": "Explicit folder list for source:'custom', and the place a folder declares its own list layout. Every other folder key stays free-form.",
@@ -4168,6 +4218,11 @@
 								]
 							}
 						},
+						"sideColumnFrom": {
+							"type": "string",
+							"minLength": 1,
+							"description": "type='detail': a field path, read like a `visibleWhen` field, whose value picks the side column and its order for this record, e.g. `@context.caseType.sideCards` (a case type that names the cards its cases show). When the value is a non-empty list of widget ids, the side column is those of `sideColumn` in that order and the rest are left out; each still follows its own `visibleWhen`. Any other value, or no value, keeps `sideColumn` as declared. Maps to CnDetailPage `sideColumnFrom`."
+						},
 						"headerActions": {
 							"type": "array",
 							"description": "Page-level header actions rendered inside CnActionsBar's overflow dropdown (between the built-in Refresh action and the `#action-items` slot). On a `type:'detail'` page the same entries render in the header's Actions menu, above the Request-a-feature / Report-a-bug / Documentation trio. Same shape as the row-level `actions[]` ($ref action), but handlers receive NO row context — they are page-level. Reserved ids (`refresh`, `import`, `export`, `copy`, `delete`) are dropped at render time to avoid shadowing built-ins. See manifest-icons-and-page-actions for the dispatch semantics.",
@@ -4301,7 +4356,7 @@
 						},
 						"fieldOverrides": {
 							"type": "object",
-							"additionalProperties": true,
+							"additionalProperties": { "$ref": "#/$defs/fieldOverride" },
 							"description": "Per-field overrides merged over the schema-derived field descriptors in the page's built-in Add/Edit form dialog (e.g. `{ \"description\": { \"widget\": \"textarea\" } }`). Which widget a field renders as belongs to the surface, not to the schema. Maps to CnIndexPage / CnDetailPage `fieldOverrides`."
 						},
 						"createDefaults": {
@@ -4667,10 +4722,24 @@
 									"variant": { "type": "string", "enum": ["primary", "secondary"], "default": "secondary" },
 									"icon": { "type": "string", "minLength": 1, "description": "MDI icon name." },
 									"format": { "type": "string", "enum": ["csv", "excel"], "default": "csv", "description": "For `export`." },
+									"run": { "type": "string", "minLength": 1, "description": "For `export`: the id of a `headerActions` entry the button runs instead of the export dialog. On a named or endpoint source an Export without `run` (and without a mass-export listener) is not drawn (2.127.0)." },
 									"items": { "type": "array", "minItems": 1, "items": { "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": false, "required": ["heading"], "properties": { "heading": { "type": "string", "minLength": 1, "description": "i18n key of a group heading." } } } ] }, "description": "For `actions-menu`: the menu's entries, in order. Each is `header-actions` (every header action), the id of one `headerActions` entry, or a built-in of the actions bar's own menu, which the bar drops while header buttons show: `import`, `export`, `refresh`, `copy-selected`, `delete-selected` (disabled until a row is selected) or `documentation` (a link to the page's documentationUrl, left out without one). An unknown name is left out. Absent: the header actions only (screens-index-header-actions-menu, 2.90.0). Entries can be grouped: `{ \"heading\": \"<i18n key>\" }` draws a group heading and `\"separator\"` a rule, each only when an entry follows it, so a group whose entries are all left out leaves no empty heading (screens-index-header-menu-headings, 2.93.0)." }
 								}
 							}
 						},
+						"search": { "type": "boolean", "default": true, "description": "type='index': `false` draws no inline search in the actions bar, also in the board look, which otherwise draws one on every index page. Wins over `inlineSearch` (2.127.0)." },
+						"searchPlacement": { "type": "string", "enum": ["", "toolbar"], "default": "", "description": "type='index', board look: where the search field sits. `toolbar` puts it on row 1 before the Filter button and the view switch instead of opening row 2 (DqTeamwachtrij, 2.127.0)." },
+						"defaultOrder": { "description": "type='index', self-fetch: the order the page opens on when neither the address nor sortKeys gives one: `\"-createdAt\"`, `\"priority:desc,title\"`, an `_order` map or a `[{ key, order }]` list (2.127.0).", "anyOf": [ { "type": "string", "minLength": 1 }, { "type": "object", "additionalProperties": { "type": "string", "enum": ["asc", "desc", "ASC", "DESC"] } }, { "type": "array", "items": { "type": "object", "required": ["key"], "properties": { "key": { "type": "string", "minLength": 1 }, "order": { "type": "string", "enum": ["asc", "desc"] } } } } ] },
+						"listConfig": {
+							"type": "object",
+							"additionalProperties": true,
+							"description": "type='index': the field mapping of the list view's rows (CnObjectRow): titleField, subtitleField, imageField, iconField, iconName, badgeField and the badge keys stay free-form. 2.127.0 types the row cells and the meta template (DqTeamwachtrij).",
+							"properties": {
+								"subtitleTemplate": { "type": "string", "minLength": 1, "description": "The meta line: `{field}` tokens filled from the row; empty parts and their separators drop." },
+								"leading": {"type": "object", "required": ["key"], "additionalProperties": true, "properties": {"key": {"type": "string", "minLength": 1}, "widget": {"type": "string", "minLength": 1}, "widgetProps": {"type": "object", "additionalProperties": true}, "formatter": {"type": "string", "minLength": 1}, "width": {"type": "string", "minLength": 1, "description": "CSS width, lining the column up across rows."}}, "description": "One cell before the title, drawn as a table column draws it (`{ key: \"createdAt\", widget: \"age\" }`)."},
+								"trailing": { "description": "A cell, or a list of cells, after the badges, each drawn as a table column draws it.", "anyOf": [ {"type": "object", "required": ["key"], "additionalProperties": true, "properties": {"key": {"type": "string", "minLength": 1}, "widget": {"type": "string", "minLength": 1}, "widgetProps": {"type": "object", "additionalProperties": true}, "formatter": {"type": "string", "minLength": 1}, "width": {"type": "string", "minLength": 1, "description": "CSS width, lining the column up across rows."}}}, { "type": "array", "items": {"type": "object", "required": ["key"], "additionalProperties": true, "properties": {"key": {"type": "string", "minLength": 1}, "widget": {"type": "string", "minLength": 1}, "widgetProps": {"type": "object", "additionalProperties": true}, "formatter": {"type": "string", "minLength": 1}, "width": {"type": "string", "minLength": 1, "description": "CSS width, lining the column up across rows."}}} } ] }
+							}
+						},
 						"rowTitle": {
 							"type": "string",
 							"enum": ["link", "plain"],

package/src/utils/nextcloudDirectory.js

@@ -64,6 +64,23 @@ export async function fetchGroupMembers(axios, groupId) {
 	return Array.isArray(users) ? users : Object.values(users)
 }
 
+/**
+ * Every user the reader may list, with their details: all users for an
+ * admin, the users of their groups for a sub-admin. Refused for others.
+ *
+ * @param {object} axios The axios instance.
+ * @param {{limit?: number}} [options] How many to read.
+ * @return {Promise<Array<object>>} Nextcloud's user details, one per user.
+ */
+export async function fetchUsers(axios, options = {}) {
+	const res = await axios.get(generateOcsUrl('cloud/users/details'), {
+		params: { limit: options.limit || 500, format: 'json' },
+		headers: OCS_HEADERS,
+	})
+	const users = (ocsData(res) && ocsData(res).users) || {}
+	return Array.isArray(users) ? users : Object.values(users)
+}
+
 /**
  * Whether a user is in today: an out-of-office period that runs now (the
  * dav app's absence, Nextcloud 28 and later), else their user status.

package/src/utils/sortOrder.js

@@ -0,0 +1,58 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+
+/**
+ * Read an order a manifest writes into the `[{ key, order }]` list a self-fetch
+ * index page sorts by. Accepted forms:
+ *
+ * - `"title"` ascending, `"-createdAt"` descending, `"priority:desc"`;
+ * - several of those, comma separated, in priority order (`"-priority,title"`);
+ * - an OpenRegister `_order` map, `{ "priority": "desc", "title": "asc" }`;
+ * - a `[{ key, order? }]` list.
+ *
+ * @param {string|object|Array|null|undefined} value The order.
+ * @return {Array<{key: string, order: 'asc'|'desc'}>} The sort keys, possibly empty.
+ */
+export function orderToSortKeys(value) {
+	const direction = (order) => (String(order || '').toLowerCase() === 'desc' ? 'desc' : 'asc')
+	if (Array.isArray(value)) {
+		return value
+			.filter((entry) => entry && typeof entry.key === 'string' && entry.key !== '')
+			.map((entry) => ({ key: entry.key, order: direction(entry.order) }))
+	}
+	if (value && typeof value === 'object') {
+		return Object.entries(value)
+			.filter(([key]) => key !== '')
+			.map(([key, order]) => ({ key, order: direction(order) }))
+	}
+	if (typeof value !== 'string') {
+		return []
+	}
+	return value.split(',')
+		.map((part) => part.trim())
+		.filter(Boolean)
+		.map((part) => {
+			if (part.startsWith('-')) {
+				return { key: part.slice(1), order: 'desc' }
+			}
+			const [key, order] = part.split(':')
+			return { key, order: direction(order) }
+		})
+		.filter((entry) => entry.key !== '')
+}
+
+/**
+ * Whether two sort key lists order the same way.
+ *
+ * @param {Array<{key: string, order: string}>} a One list.
+ * @param {Array<{key: string, order: string}>} b The other.
+ * @return {boolean} True when they name the same keys, directions and priority.
+ */
+export function sameSortKeys(a, b) {
+	const left = Array.isArray(a) ? a : []
+	const right = Array.isArray(b) ? b : []
+	return left.length === right.length
+		&& left.every((entry, index) => entry.key === right[index].key && (entry.order || 'asc') === (right[index].order || 'asc'))
+}