@conduction/nextcloud-vue 2.71.0 → 2.72.0

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: 35657637 bytes
-sha256: b7b966a528988db88e213ce0afc88832aae9c6b60341877ba5226dc3d833f211
+size: 35684577 bytes
+sha256: 40220f92c6defbd478644408d9d23a88047c47798fb52eefee28e6d70e0fbc9a

package/dist/nextcloud-vue.css

@@ -26582,6 +26582,18 @@ a.cn-flow-runs-widget__row-content:hover .cn-flow-runs-widget__name[data-v-75628
 	font-size: 0.85em;
 	color: var(--color-text-maxcontrast);
 }
+
+/* Full width, like the text fields around it: at its natural width the
+   picker cut every option label in half. */
+.cn-flow-node-edit__select[data-v-e107484a] {
+	width: 100%;
+}
+.cn-flow-node-edit__field-help[data-v-e107484a] {
+	margin: 4px 0 0;
+	padding-inline-start: 8px;
+	font-size: 0.85em;
+	color: var(--color-text-maxcontrast);
+}
 .cn-flow-node-edit__advanced summary[data-v-e107484a] {
 	cursor: pointer;
 	color: var(--color-text-maxcontrast);
@@ -28036,6 +28048,58 @@ to {
 }
 
 
+.cn-flow-step-outcomes[data-v-5ac5ad4f] {
+	margin: 4px 0 0;
+	font-size: 0.9em;
+}
+.cn-flow-step-outcomes__list[data-v-5ac5ad4f] {
+	margin: 0;
+	padding: 0;
+}
+
+/* Stacked, name over value: the run sidebar is narrow, and a side-by-side
+   row wrapped mid-list. The host's dt/dd margins and alignment are reset. */
+.cn-flow-step-outcomes__row[data-v-5ac5ad4f] {
+	display: block;
+	margin-block: 4px;
+	padding-block: 2px;
+	padding-inline-start: 8px;
+	border-inline-start: 3px solid var(--color-border);
+	text-align: start;
+}
+.cn-flow-step-outcomes__row--success[data-v-5ac5ad4f] {
+	border-inline-start-color: var(--color-success);
+}
+.cn-flow-step-outcomes__row--warning[data-v-5ac5ad4f] {
+	border-inline-start-color: var(--color-warning);
+}
+.cn-flow-step-outcomes__row--error[data-v-5ac5ad4f] {
+	border-inline-start-color: var(--color-error);
+}
+.cn-flow-step-outcomes__name[data-v-5ac5ad4f] {
+	display: block;
+	white-space: normal;
+	overflow-wrap: anywhere;
+	margin: 0;
+	padding: 0;
+	font-weight: bold;
+	text-align: start;
+}
+.cn-flow-step-outcomes__value[data-v-5ac5ad4f] {
+	display: block;
+	white-space: normal;
+	margin: 0;
+	padding: 0;
+	text-align: start;
+	color: var(--color-main-text);
+	overflow-wrap: anywhere;
+}
+.cn-flow-step-outcomes__truncated[data-v-5ac5ad4f] {
+	margin: 4px 0 0;
+	color: var(--color-text-maxcontrast);
+}
+
+
 .cn-run-sidebar[data-v-48e781f0] {
 	display: flex;
 	flex-direction: column;

package/l10n/en.json

@@ -1106,7 +1106,21 @@
     "Loading…": "Loading…",
     "A register and schema are required": "A register and schema are required",
     "Change the search or try again.": "Change the search or try again.",
-    "Try again later.": "Try again later."
+    "Try again later.": "Try again later.",
+    "Who this step reached": "Who this step reached",
+    "Each list shows its first entries only.": "Each list shows its first entries only.",
+    "Delivered": "Delivered",
+    "Opted out": "Opted out",
+    "Not sent, the opt-out check did not answer": "Not sent, the opt-out check did not answer",
+    "Skipped by their notification settings": "Skipped by their notification settings",
+    "Skipped, sending is switched off": "Skipped, sending is switched off",
+    "Held back by the send limit": "Held back by the send limit",
+    "Refused by the step’s address rule": "Refused by the step’s address rule",
+    "Not a known user or group": "Not a known user or group",
+    "Failed": "Failed",
+    "external recipients are off": "external recipients are off",
+    "not on the item": "not on the item",
+    "not a valid address": "not a valid address"
   },
   "plurals": {
     "%n year": ["%n year", "%n years"],

package/l10n/nl.json

@@ -1150,7 +1150,21 @@
     "Loading…": "Laden…",
     "A register and schema are required": "Een register en schema zijn verplicht",
     "Change the search or try again.": "Pas de zoekopdracht aan of probeer het opnieuw.",
-    "Try again later.": "Probeer het later opnieuw."
+    "Try again later.": "Probeer het later opnieuw.",
+    "Who this step reached": "Wie deze stap bereikte",
+    "Each list shows its first entries only.": "Elke lijst toont alleen de eerste vermeldingen.",
+    "Delivered": "Bezorgd",
+    "Opted out": "Afgemeld",
+    "Not sent, the opt-out check did not answer": "Niet verstuurd, de afmeldcontrole gaf geen antwoord",
+    "Skipped by their notification settings": "Overgeslagen door hun meldingsinstellingen",
+    "Skipped, sending is switched off": "Overgeslagen, verzenden staat uit",
+    "Held back by the send limit": "Tegengehouden door de verzendlimiet",
+    "Refused by the step’s address rule": "Geweigerd door de adresregel van de stap",
+    "Not a known user or group": "Geen bekende gebruiker of groep",
+    "Failed": "Mislukt",
+    "external recipients are off": "externe ontvangers staan uit",
+    "not on the item": "staat niet op het item",
+    "not a valid address": "geen geldig adres"
   },
   "plurals": {
     "%n year": ["%n jaar", "%n jaar"],

package/package.json

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

package/src/components/CnFlowDetail/CnRunDetailSidebar.vue

@@ -226,6 +226,10 @@
 					<strong>{{ step.transition }}</strong>
 					<span class="cn-run-sidebar__hint"> · {{ step.status }}</span>
 					<span v-if="step.error" class="cn-run-sidebar__error"> · {{ step.error }}</span>
+					<!-- A send step's outcome lists, by name: who got it, who
+					     opted out, who the opt-out check could not answer for. -->
+					<CnFlowStepOutcomes v-if="step.report && step.report.messaging"
+						:report="step.report.messaging" />
 				</li>
 			</ol>
 		</component>
@@ -241,6 +245,7 @@ import CheckboxMarkedOutline from 'vue-material-design-icons/CheckboxMarkedOutli
 import DatabaseOutline from 'vue-material-design-icons/DatabaseOutline.vue'
 import FormatListBulleted from 'vue-material-design-icons/FormatListBulleted.vue'
 import Replay from 'vue-material-design-icons/Replay.vue'
+import CnFlowStepOutcomes from '../CnFlowStepOutcomes/CnFlowStepOutcomes.vue'
 import { FLOW_RUN_ACTIVE_STATUSES, useFlowStore } from '../../composables/useFlowStore.js'
 
 export default {
@@ -249,6 +254,7 @@ export default {
 	components: {
 		ArrowLeft,
 		CheckboxMarkedOutline,
+		CnFlowStepOutcomes,
 		DatabaseOutline,
 		FormatListBulleted,
 		NcAppSidebarTab,

package/src/components/CnFlowStepOutcomes/CnFlowStepOutcomes.vue

@@ -0,0 +1,250 @@
+<!--
+  CnFlowStepOutcomes: who a send step reached, and who it did not, by name.
+
+  A messaging step (send email, send notification, post to Talk) writes its
+  per-recipient outcome onto its run-log entry as `report.messaging`: one
+  bucket per outcome, each `{count, sample}`. Nothing rendered it, so the run
+  log could not show that a person was skipped because they opted out, or
+  because the opt-out check did not answer.
+
+  Only buckets with someone in them are listed. A bucket this component does
+  not know is still shown, under its own key made readable, so a new outcome
+  on the server is never hidden by an older library.
+
+  SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+  SPDX-License-Identifier: EUPL-1.2
+-->
+<template>
+	<div v-if="rows.length" class="cn-flow-step-outcomes" data-testid="flow-step-outcomes">
+		<dl class="cn-flow-step-outcomes__list" :aria-label="t('nextcloud-vue', 'Who this step reached')">
+			<div v-for="row in rows"
+				:key="row.key"
+				class="cn-flow-step-outcomes__row"
+				:class="`cn-flow-step-outcomes__row--${row.tone}`"
+				:data-testid="`flow-step-outcome-${row.key}`">
+				<dt class="cn-flow-step-outcomes__name">
+					{{ row.label }}
+				</dt>
+				<dd class="cn-flow-step-outcomes__value">
+					<span class="cn-flow-step-outcomes__count">{{ row.count }}</span>
+					<span v-if="row.sample.length" class="cn-flow-step-outcomes__sample"> · {{ row.sample.join(', ') }}</span>
+				</dd>
+			</div>
+		</dl>
+		<p v-if="report && report.truncated"
+			class="cn-flow-step-outcomes__truncated"
+			data-testid="flow-step-outcomes-truncated">
+			{{ t('nextcloud-vue', 'Each list shows its first entries only.') }}
+		</p>
+	</div>
+</template>
+
+<script>
+import { translate as t } from '@nextcloud/l10n'
+
+/**
+ * The buckets a messaging report carries, in reading order: who got it first,
+ * then each reason someone did not. `tone` marks the row for styling only.
+ */
+const KNOWN_BUCKETS = [
+	{ key: 'delivered', tone: 'success' },
+	{ key: 'optedOut', tone: 'neutral' },
+	{ key: 'authorityUnavailable', tone: 'warning' },
+	{ key: 'skippedByPreference', tone: 'neutral' },
+	{ key: 'skippedByKillSwitch', tone: 'neutral' },
+	{ key: 'rateLimited', tone: 'warning' },
+	{ key: 'refusedRecipients', tone: 'warning' },
+	{ key: 'unknownRecipients', tone: 'warning' },
+	{ key: 'failed', tone: 'error' },
+]
+
+/** Report keys that are facts about the send, not outcome buckets. */
+const NOT_BUCKETS = ['channel', 'actor', 'recipients', 'truncated']
+
+export default {
+	name: 'CnFlowStepOutcomes',
+
+	props: {
+		/**
+		 * A step's messaging report: the run-log entry's `report.messaging`.
+		 * Each outcome bucket is `{count, sample}`; a `refusedRecipients`
+		 * sample entry is `{recipient, reason}`. `null` renders nothing.
+		 */
+		report: {
+			type: Object,
+			default: null,
+		},
+
+		/**
+		 * Names to use instead of the built-in ones, keyed by bucket
+		 * (`{ optedOut: 'Unsubscribed' }`). Pass already-translated text.
+		 */
+		labels: {
+			type: Object,
+			default: () => ({}),
+		},
+	},
+
+	computed: {
+		/**
+		 * The non-empty buckets, known ones first in reading order, then any
+		 * bucket the server added that this component does not know.
+		 *
+		 * @return {Array<object>} One row per bucket: key, label, count, sample, tone.
+		 */
+		rows() {
+			const report = this.report
+			if (!report || typeof report !== 'object') {
+				return []
+			}
+
+			const known = KNOWN_BUCKETS.map((bucket) => bucket.key)
+			const extra = Object.keys(report).filter((key) => !known.includes(key) && !NOT_BUCKETS.includes(key))
+			const ordered = [
+				...KNOWN_BUCKETS,
+				...extra.map((key) => ({ key, tone: 'neutral' })),
+			]
+
+			return ordered
+				.map(({ key, tone }) => ({ key, tone, bucket: report[key] }))
+				.filter(({ bucket }) => bucket && typeof bucket === 'object' && Number(bucket.count) > 0)
+				.map(({ key, tone, bucket }) => ({
+					key,
+					tone,
+					label: this.labelFor(key),
+					count: Number(bucket.count),
+					sample: (Array.isArray(bucket.sample) ? bucket.sample : []).map((entry) => this.describeEntry(entry)),
+				}))
+		},
+	},
+
+	methods: {
+		t,
+
+		/**
+		 * The readable name of a bucket: the host's, then the built-in one,
+		 * then the key itself (`heldForReview` reads "Held for review").
+		 *
+		 * @param {string} key The bucket key.
+		 * @return {string} The name.
+		 */
+		labelFor(key) {
+			if (this.labels && this.labels[key]) {
+				return String(this.labels[key])
+			}
+
+			const builtIn = {
+				delivered: t('nextcloud-vue', 'Delivered'),
+				optedOut: t('nextcloud-vue', 'Opted out'),
+				authorityUnavailable: t('nextcloud-vue', 'Not sent, the opt-out check did not answer'),
+				skippedByPreference: t('nextcloud-vue', 'Skipped by their notification settings'),
+				skippedByKillSwitch: t('nextcloud-vue', 'Skipped, sending is switched off'),
+				rateLimited: t('nextcloud-vue', 'Held back by the send limit'),
+				refusedRecipients: t('nextcloud-vue', 'Refused by the step’s address rule'),
+				unknownRecipients: t('nextcloud-vue', 'Not a known user or group'),
+				failed: t('nextcloud-vue', 'Failed'),
+			}
+			if (builtIn[key]) {
+				return builtIn[key]
+			}
+
+			const words = String(key).replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/[-_]+/g, ' ').trim().toLowerCase()
+
+			return words.charAt(0).toUpperCase() + words.slice(1)
+		},
+
+		/**
+		 * One sample entry as text. A refused address carries its reason.
+		 *
+		 * @param {string|object} entry The sample entry.
+		 * @return {string} The text.
+		 */
+		describeEntry(entry) {
+			if (entry && typeof entry === 'object') {
+				const who = String(entry.recipient ?? entry.id ?? '')
+				const reason = this.reasonFor(entry.reason)
+
+				return reason ? `${who} (${reason})` : who
+			}
+
+			return String(entry)
+		},
+
+		/**
+		 * Why the step's address rule refused an address, in words.
+		 *
+		 * @param {string} [code] The refusal code.
+		 * @return {string} The reason, or the code when it is not known.
+		 */
+		reasonFor(code) {
+			const reasons = {
+				'external-recipients-off': t('nextcloud-vue', 'external recipients are off'),
+				'not-on-item': t('nextcloud-vue', 'not on the item'),
+				'invalid-address': t('nextcloud-vue', 'not a valid address'),
+			}
+
+			return code ? (reasons[code] || String(code)) : ''
+		},
+	},
+}
+</script>
+
+<style scoped>
+.cn-flow-step-outcomes {
+	margin: 4px 0 0;
+	font-size: 0.9em;
+}
+
+.cn-flow-step-outcomes__list {
+	margin: 0;
+	padding: 0;
+}
+
+/* Stacked, name over value: the run sidebar is narrow, and a side-by-side
+   row wrapped mid-list. The host's dt/dd margins and alignment are reset. */
+.cn-flow-step-outcomes__row {
+	display: block;
+	margin-block: 4px;
+	padding-block: 2px;
+	padding-inline-start: 8px;
+	border-inline-start: 3px solid var(--color-border);
+	text-align: start;
+}
+
+.cn-flow-step-outcomes__row--success {
+	border-inline-start-color: var(--color-success);
+}
+
+.cn-flow-step-outcomes__row--warning {
+	border-inline-start-color: var(--color-warning);
+}
+
+.cn-flow-step-outcomes__row--error {
+	border-inline-start-color: var(--color-error);
+}
+
+.cn-flow-step-outcomes__name {
+	display: block;
+	white-space: normal;
+	overflow-wrap: anywhere;
+	margin: 0;
+	padding: 0;
+	font-weight: bold;
+	text-align: start;
+}
+
+.cn-flow-step-outcomes__value {
+	display: block;
+	white-space: normal;
+	margin: 0;
+	padding: 0;
+	text-align: start;
+	color: var(--color-main-text);
+	overflow-wrap: anywhere;
+}
+
+.cn-flow-step-outcomes__truncated {
+	margin: 4px 0 0;
+	color: var(--color-text-maxcontrast);
+}
+</style>

package/src/components/CnFlowStepOutcomes/index.js

@@ -0,0 +1,8 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+import CnFlowStepOutcomes from './CnFlowStepOutcomes.vue'
+
+export default CnFlowStepOutcomes
+export { CnFlowStepOutcomes }

package/src/components/index.js

@@ -191,6 +191,7 @@ export { CnDeltaWidgetForm } from './CnDeltaWidgetForm/index.js'
 export { CnGaugeWidget } from './CnGaugeWidget/index.js'
 export { CnGaugeWidgetForm } from './CnGaugeWidgetForm/index.js'
 export { CnFlowRunsWidget } from './CnFlowRunsWidget/index.js'
+export { CnFlowStepOutcomes } from './CnFlowStepOutcomes/index.js'
 export { CnFlowRunsWidgetForm } from './CnFlowRunsWidgetForm/index.js'
 export { CnTasksWidget } from './CnTasksWidget/index.js'
 export { CnTasksWidgetForm } from './CnTasksWidgetForm/index.js'

package/src/dialogs/CnFlowNodeEditModal.vue

@@ -40,16 +40,27 @@
 					:placeholder="t('nextcloud-vue', 'GET')"
 					@update:modelValue="setKey(key, $event)" />
 
-				<!-- A `select` field with `optionsFrom` renders as a picker fed
-				     by the URL the OWNING APP declared — never a bare uuid
-				     text box. -->
-				<NcSelect v-else-if="widgetFor(key) === 'select'"
-					:modelValue="selectedOption(key)"
-					:options="selectOptions[key] || []"
-					:inputLabel="labelFor(key)"
-					:loading="selectLoading[key] === true"
-					:placeholder="t('nextcloud-vue', 'Pick one…')"
-					@update:modelValue="setKey(key, $event ? $event.id : '')" />
+				<!-- A `select` field renders as a picker, never a bare text box.
+				     Its choices come from the URL the OWNING APP declared
+				     (`optionsFrom`) or from the form itself (`options`), for a
+				     short fixed vocabulary with no endpoint of its own. -->
+				<template v-else-if="widgetFor(key) === 'select'">
+					<NcSelect :modelValue="selectedOption(key)"
+						class="cn-flow-node-edit__select"
+						:options="selectOptions[key] || []"
+						:inputLabel="labelFor(key)"
+						:loading="selectLoading[key] === true"
+						:placeholder="t('nextcloud-vue', 'Pick one…')"
+						@update:modelValue="setKey(key, $event ? $event.id : '')" />
+					<!-- NcSelect has no helper text of its own, so the help
+					     follows the control, the next thing a screen reader
+					     reads after it. -->
+					<p v-if="hintFor(key)"
+						class="cn-flow-node-edit__field-help"
+						:data-testid="`flow-node-help-${key}`">
+						{{ hintFor(key) }}
+					</p>
+				</template>
 
 				<NcTextArea v-else-if="widgetFor(key) === 'textarea'"
 					:modelValue="String(draft.config[key] ?? '')"
@@ -170,6 +181,7 @@ import {
 } from '@nextcloud/vue'
 import CnCronField from '../components/CnCronField/CnCronField.vue'
 import { useFlowStore } from '../composables/useFlowStore.js'
+import { hasStaticOptions, normaliseSelectOptions } from '../utils/selectOptions.js'
 
 /** The verbs an HTTP-shaped `method` option can take. */
 /**
@@ -287,7 +299,7 @@ export default {
 
 		/**
 		 * The node's per-field declarations from the catalogue's `configForm`
-		 * ({key, label, type, help, required, optionsFrom}), keyed by config
+		 * ({key, label, type, help, required, optionsFrom, options}), keyed by config
 		 * key. `configKeys` is the degraded form. Either way the node's OWNER
 		 * declares the vocabulary — this dialog never invents fields.
 		 *
@@ -398,7 +410,9 @@ export default {
 	created() {
 		// Select fields need their options; everything else is local.
 		for (const [key, spec] of Object.entries(this.fieldSpecs)) {
-			if (spec?.type === 'select' && spec?.optionsFrom) {
+			if (hasStaticOptions(spec)) {
+				this.selectOptions = { ...this.selectOptions, [key]: normaliseSelectOptions(spec.options) }
+			} else if (spec?.type === 'select' && spec?.optionsFrom) {
 				this.loadSelectOptions(key, spec)
 			}
 		}
@@ -634,7 +648,7 @@ export default {
 		 */
 		widgetFor(key) {
 			const spec = this.fieldSpecs[key]
-			if (spec?.type === 'select' && spec?.optionsFrom) {
+			if (spec?.type === 'select' && (spec?.optionsFrom || hasStaticOptions(spec))) {
 				return 'select'
 			}
 			if (spec?.type === 'boolean') {
@@ -730,13 +744,7 @@ export default {
 					? generateUrl(url)
 					: url)
 				const rows = Array.isArray(response.data) ? response.data : (response.data?.results || [])
-				const options = rows.map((row) => {
-					const id = row.id ?? row.value ?? row['@self']?.uuid ?? row.uuid
-					return {
-						id,
-						label: row.label || row.name || row.title || String(id),
-					}
-				}).filter((o) => o.id !== undefined && o.id !== null && o.id !== '')
+				const options = normaliseSelectOptions(rows)
 				this.selectOptions = { ...this.selectOptions, [key]: options }
 			} catch (error) {
 				// A picker that could not load degrades to showing the stored
@@ -930,6 +938,19 @@ export default {
 	color: var(--color-text-maxcontrast);
 }
 
+/* Full width, like the text fields around it: at its natural width the
+   picker cut every option label in half. */
+.cn-flow-node-edit__select {
+	width: 100%;
+}
+
+.cn-flow-node-edit__field-help {
+	margin: 4px 0 0;
+	padding-inline-start: 8px;
+	font-size: 0.85em;
+	color: var(--color-text-maxcontrast);
+}
+
 .cn-flow-node-edit__advanced summary {
 	cursor: pointer;
 	color: var(--color-text-maxcontrast);

package/src/dialogs/CnRunNodeDialog.vue

@@ -88,6 +88,7 @@
 import { translate as t } from '@nextcloud/l10n'
 import { NcButton, NcCheckboxRadioSwitch, NcDialog, NcLoadingIcon, NcNoteCard, NcSelect, NcTextArea, NcTextField } from '@nextcloud/vue'
 import { prefixUrl } from '../utils/headers.js'
+import { hasStaticOptions, normaliseSelectOptions } from '../utils/selectOptions.js'
 
 /**
  * The dialog `run-node` opens to collect a directly-invoked flow node's own
@@ -128,7 +129,9 @@ export default {
 		title: { type: String, default: '' },
 		/**
 		 * The node's declared config form — `IFlowNodeConfigForm::configForm()`'s
-		 * shape, unchanged: `[{key, label, type, help?, required?, optionsFrom?}]`.
+		 * shape, unchanged: `[{key, label, type, help?, required?, optionsFrom?, options?}]`.
+		 * A `select` takes its choices from `optionsFrom` (a url) or `options`
+		 * (strings, or `{value, label}` pairs declared in the form itself).
 		 *
 		 * @type {Array<object>}
 		 */
@@ -177,7 +180,9 @@ export default {
 				}
 				this.values = seed
 				for (const field of (fields || [])) {
-					if (field.type === 'select' && field.optionsFrom) {
+					if (hasStaticOptions(field)) {
+						this.options = { ...this.options, [field.key]: normaliseSelectOptions(field.options, (s) => this.tr(s)) }
+					} else if (field.type === 'select' && field.optionsFrom) {
 						this.loadOptions(field)
 					}
 				}
@@ -274,10 +279,7 @@ export default {
 				const url = prefixUrl(raw)
 				const response = await axios.get(url)
 				const rows = Array.isArray(response.data) ? response.data : (response.data?.results || [])
-				const opts = rows.map((row) => {
-					const id = row.id ?? row.value ?? row['@self']?.uuid ?? row.uuid
-					return { id, label: row.label || row.name || row.title || String(id) }
-				}).filter((o) => o.id !== undefined && o.id !== null && o.id !== '')
+				const opts = normaliseSelectOptions(rows)
 				this.options = { ...this.options, [field.key]: opts }
 			} catch (error) {
 				// A picker that fails to load degrades to an empty list rather

package/src/index.js

@@ -129,6 +129,7 @@ export {
 	CnFlowRunsWidgetForm,
 	CnFlowSidebar,
 	CnFlowsPage,
+	CnFlowStepOutcomes,
 	CnFolderSidebar,
 	CnFolderTree,
 	CnFormBuilder,

package/src/utils/selectOptions.js

@@ -0,0 +1,54 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The choices a node's `select` field offers, in the `{id, label}` shape
+ * NcSelect takes.
+ *
+ * A field gets its choices one of two ways. `optionsFrom` names a url the
+ * owning app answers. `options` lists them in the form itself, for a short
+ * fixed vocabulary that has no endpoint of its own. Both dialogs that render a
+ * node's configForm read the same shapes through this module, so the two
+ * cannot come to accept different ones.
+ */
+
+/**
+ * Normalise rows into `{id, label}` options.
+ *
+ * Accepts plain strings and numbers, `{id, label}`, `{value, label}`, and
+ * OpenRegister objects (uuid from `@self`, label from name or title). A row
+ * without an id is dropped rather than shown as a blank option.
+ *
+ * @param {Array<unknown>} rows The raw rows.
+ * @param {(label: string) => string} [translate] Applied to each declared label.
+ * @return {Array<{id: string|number, label: string}>} The options.
+ */
+export function normaliseSelectOptions(rows, translate = (s) => s) {
+	if (!Array.isArray(rows)) {
+		return []
+	}
+
+	return rows.map((row) => {
+		if (typeof row === 'string' || typeof row === 'number') {
+			return { id: row, label: String(row) }
+		}
+		if (!row || typeof row !== 'object') {
+			return { id: undefined, label: '' }
+		}
+
+		const id = row.id ?? row.value ?? row['@self']?.uuid ?? row.uuid
+		const declared = row.label || row.name || row.title
+
+		return { id, label: declared ? String(translate(declared)) : String(id) }
+	}).filter((option) => option.id !== undefined && option.id !== null && option.id !== '')
+}
+
+/**
+ * Whether a field declares its choices in the form itself.
+ *
+ * @param {object} field The field declaration.
+ * @return {boolean} True for a `select` with an `options` list.
+ */
+export function hasStaticOptions(field) {
+	return field?.type === 'select' && Array.isArray(field?.options)
+}