@conduction/nextcloud-vue 2.62.0 → 2.63.0

package/dist/esm/utils/pickerOptions.js

@@ -0,0 +1,198 @@
+import { getLanguage } from '@nextcloud/l10n';
+
+/**
+ * Option lists for the language and time zone pickers, and the defaults a
+ * schema can ask for with `x-default`.
+ *
+ * Both pickers store a code (`nl`, `Europe/Amsterdam`) and show a label in
+ * the user's own language, so a person picks "Nederlands" and the record
+ * stores `nl`.
+ *
+ * @module utils/pickerOptions
+ */
+
+
+/**
+ * ISO 639-1 language codes. `Intl` has no list of languages, so the codes
+ * live here; the labels come from `Intl.DisplayNames` at runtime.
+ *
+ * @type {string[]}
+ */
+const LANGUAGE_CODES = (''
+	+ 'aa ab af ak am an ar as av ay az ba be bg bi bm bn bo br bs '
+	+ 'ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu '
+	+ 'fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu '
+	+ 'hy hz ia id ie ig ii ik io is it iu ja jv ka kg ki kj kk kl '
+	+ 'km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh '
+	+ 'mi mk ml mn mr ms mt my na nb nd ne ng nl nn no nr nv ny oc '
+	+ 'oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg '
+	+ 'si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl '
+	+ 'tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za '
+	+ 'zh zu'
+).split(' ');
+
+/**
+ * A small fallback for runtimes without `Intl.supportedValuesOf`.
+ *
+ * @type {string[]}
+ */
+const FALLBACK_TIMEZONES = 'UTC Europe/Amsterdam Europe/Berlin Europe/Brussels Europe/London Europe/Paris America/New_York America/Chicago America/Los_Angeles Asia/Tokyo Australia/Sydney'.split(' ');
+
+/**
+ * The user's Nextcloud language as a BCP 47 tag (`en_GB` becomes `en-GB`).
+ *
+ * @return {string} The tag, `en` when Nextcloud reports nothing.
+ */
+function currentLanguageTag() {
+	let lang;
+	try {
+		lang = getLanguage();
+	} catch {
+		lang = '';
+	}
+	return String(lang || 'en').replace(/_/g, '-')
+}
+
+/**
+ * The browser's time zone (IANA id).
+ *
+ * @return {string} The time zone, `UTC` when the runtime does not say.
+ */
+function currentTimezone() {
+	try {
+		return Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC'
+	} catch {
+		return 'UTC'
+	}
+}
+
+/**
+ * Cached option lists, keyed by display language. Stable identity matters:
+ * the form's select matches the chosen option by reference.
+ *
+ * @type {Map<string, {codes: string[], labels: object}>}
+ */
+const languageCache = new Map();
+
+/**
+ * The language picker's codes and labels, labelled in `displayLanguage`.
+ *
+ * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md
+ * @param {string} [displayLanguage] BCP 47 tag the labels are written in; defaults to the user's language.
+ * @return {{codes: string[], labels: object}} Codes sorted by label, and `{ code: label }`.
+ */
+function languageOptions(displayLanguage) {
+	const locale = displayLanguage || currentLanguageTag();
+	if (languageCache.has(locale)) {
+		return languageCache.get(locale)
+	}
+	let names;
+	try {
+		names = new Intl.DisplayNames([locale, 'en'], { type: 'language' });
+	} catch {
+		names = null;
+	}
+	const labels = {};
+	for (const code of LANGUAGE_CODES) {
+		let label;
+		try {
+			label = (names && names.of(code)) || code;
+		} catch {
+			label = code;
+		}
+		// `Intl` lower-cases some names ("nederlands" is fine in a sentence,
+		// not in a list); capitalise the first letter for the list.
+		labels[code] = label.charAt(0).toLocaleUpperCase(locale) + label.slice(1);
+	}
+	const codes = [...LANGUAGE_CODES].sort((a, b) => labels[a].localeCompare(labels[b], locale));
+	const result = { codes, labels };
+	languageCache.set(locale, result);
+	return result
+}
+
+/** @type {{codes: string[], labels: object}|null} */
+let timezoneCache = null;
+
+/**
+ * The time zone picker's codes and labels (`Europe/Amsterdam` shows as
+ * `Europe/Amsterdam`, underscores as spaces).
+ *
+ * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md
+ * @return {{codes: string[], labels: object}} IANA ids, and `{ id: label }`.
+ */
+function timezoneOptions() {
+	if (timezoneCache) {
+		return timezoneCache
+	}
+	let codes;
+	try {
+		codes = typeof Intl.supportedValuesOf === 'function' ? Intl.supportedValuesOf('timeZone') : [];
+	} catch {
+		codes = [];
+	}
+	if (!codes.length) {
+		codes = FALLBACK_TIMEZONES;
+	}
+	if (!codes.includes('UTC')) {
+		codes = ['UTC', ...codes];
+	}
+	const labels = {};
+	for (const code of codes) {
+		labels[code] = code.replace(/_/g, ' ');
+	}
+	timezoneCache = { codes: [...codes], labels };
+	return timezoneCache
+}
+
+/**
+ * Fit a language tag to the property's `pattern`, if it has one.
+ *
+ * A schema that stores ISO 639-1 (`^[a-z]{2}$`) cannot take `en-GB`, so the
+ * tag falls back to its primary subtag. Without a pattern the full tag stays.
+ *
+ * @param {string} tag A BCP 47 tag.
+ * @param {string|undefined} pattern The property's `pattern`.
+ * @return {string} The tag as the schema accepts it.
+ */
+function fitLanguageTag(tag, pattern) {
+	if (!pattern) {
+		return tag
+	}
+	let re;
+	try {
+		re = new RegExp(pattern);
+	} catch {
+		return tag
+	}
+	if (re.test(tag)) {
+		return tag
+	}
+	const primary = tag.split('-')[0].toLowerCase();
+	return re.test(primary) ? primary : tag
+}
+
+/**
+ * Resolve an `x-default` token to the value a NEW object starts with.
+ *
+ * - `current-language`: the user's Nextcloud language (BCP 47, fitted to the
+ *   property's `pattern`).
+ * - `current-timezone`: the browser's time zone.
+ *
+ * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md
+ * @param {string|null} token The `x-default` value.
+ * @param {object} [field] The field descriptor (reads `validation.pattern`).
+ * @return {string|null} The value, or null for an unknown token.
+ */
+function resolveDefaultToken(token, field = {}) {
+	if (token === 'current-language') {
+		const pattern = field && field.validation ? field.validation.pattern : undefined;
+		return fitLanguageTag(currentLanguageTag(), pattern)
+	}
+	if (token === 'current-timezone') {
+		return currentTimezone()
+	}
+	return null
+}
+
+export { LANGUAGE_CODES, currentLanguageTag, currentTimezone, languageOptions, resolveDefaultToken, timezoneOptions };
+//# sourceMappingURL=pickerOptions.js.map

package/dist/esm/utils/pickerOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pickerOptions.js","sources":["../../../src/utils/pickerOptions.js"],"sourcesContent":["/**\n * Option lists for the language and time zone pickers, and the defaults a\n * schema can ask for with `x-default`.\n *\n * Both pickers store a code (`nl`, `Europe/Amsterdam`) and show a label in\n * the user's own language, so a person picks \"Nederlands\" and the record\n * stores `nl`.\n *\n * @module utils/pickerOptions\n */\n\nimport { getLanguage } from '@nextcloud/l10n'\n\n/**\n * ISO 639-1 language codes. `Intl` has no list of languages, so the codes\n * live here; the labels come from `Intl.DisplayNames` at runtime.\n *\n * @type {string[]}\n */\nexport const LANGUAGE_CODES = (''\n\t+ 'aa ab af ak am an ar as av ay az ba be bg bi bm bn bo br bs '\n\t+ 'ca ce ch co cr cs cu cv cy da de dv dz ee el en eo es et eu '\n\t+ 'fa ff fi fj fo fr fy ga gd gl gn gu gv ha he hi ho hr ht hu '\n\t+ 'hy hz ia id ie ig ii ik io is it iu ja jv ka kg ki kj kk kl '\n\t+ 'km kn ko kr ks ku kv kw ky la lb lg li ln lo lt lu lv mg mh '\n\t+ 'mi mk ml mn mr ms mt my na nb nd ne ng nl nn no nr nv ny oc '\n\t+ 'oj om or os pa pi pl ps pt qu rm rn ro ru rw sa sc sd se sg '\n\t+ 'si sk sl sm sn so sq sr ss st su sv sw ta te tg th ti tk tl '\n\t+ 'tn to tr ts tt tw ty ug uk ur uz ve vi vo wa wo xh yi yo za '\n\t+ 'zh zu'\n).split(' ')\n\n/**\n * A small fallback for runtimes without `Intl.supportedValuesOf`.\n *\n * @type {string[]}\n */\nconst FALLBACK_TIMEZONES = 'UTC Europe/Amsterdam Europe/Berlin Europe/Brussels Europe/London Europe/Paris America/New_York America/Chicago America/Los_Angeles Asia/Tokyo Australia/Sydney'.split(' ')\n\n/**\n * The user's Nextcloud language as a BCP 47 tag (`en_GB` becomes `en-GB`).\n *\n * @return {string} The tag, `en` when Nextcloud reports nothing.\n */\nexport function currentLanguageTag() {\n\tlet lang\n\ttry {\n\t\tlang = getLanguage()\n\t} catch {\n\t\tlang = ''\n\t}\n\treturn String(lang || 'en').replace(/_/g, '-')\n}\n\n/**\n * The browser's time zone (IANA id).\n *\n * @return {string} The time zone, `UTC` when the runtime does not say.\n */\nexport function currentTimezone() {\n\ttry {\n\t\treturn Intl.DateTimeFormat().resolvedOptions().timeZone || 'UTC'\n\t} catch {\n\t\treturn 'UTC'\n\t}\n}\n\n/**\n * Cached option lists, keyed by display language. Stable identity matters:\n * the form's select matches the chosen option by reference.\n *\n * @type {Map<string, {codes: string[], labels: object}>}\n */\nconst languageCache = new Map()\n\n/**\n * The language picker's codes and labels, labelled in `displayLanguage`.\n *\n * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md\n * @param {string} [displayLanguage] BCP 47 tag the labels are written in; defaults to the user's language.\n * @return {{codes: string[], labels: object}} Codes sorted by label, and `{ code: label }`.\n */\nexport function languageOptions(displayLanguage) {\n\tconst locale = displayLanguage || currentLanguageTag()\n\tif (languageCache.has(locale)) {\n\t\treturn languageCache.get(locale)\n\t}\n\tlet names\n\ttry {\n\t\tnames = new Intl.DisplayNames([locale, 'en'], { type: 'language' })\n\t} catch {\n\t\tnames = null\n\t}\n\tconst labels = {}\n\tfor (const code of LANGUAGE_CODES) {\n\t\tlet label\n\t\ttry {\n\t\t\tlabel = (names && names.of(code)) || code\n\t\t} catch {\n\t\t\tlabel = code\n\t\t}\n\t\t// `Intl` lower-cases some names (\"nederlands\" is fine in a sentence,\n\t\t// not in a list); capitalise the first letter for the list.\n\t\tlabels[code] = label.charAt(0).toLocaleUpperCase(locale) + label.slice(1)\n\t}\n\tconst codes = [...LANGUAGE_CODES].sort((a, b) => labels[a].localeCompare(labels[b], locale))\n\tconst result = { codes, labels }\n\tlanguageCache.set(locale, result)\n\treturn result\n}\n\n/** @type {{codes: string[], labels: object}|null} */\nlet timezoneCache = null\n\n/**\n * The time zone picker's codes and labels (`Europe/Amsterdam` shows as\n * `Europe/Amsterdam`, underscores as spaces).\n *\n * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md\n * @return {{codes: string[], labels: object}} IANA ids, and `{ id: label }`.\n */\nexport function timezoneOptions() {\n\tif (timezoneCache) {\n\t\treturn timezoneCache\n\t}\n\tlet codes\n\ttry {\n\t\tcodes = typeof Intl.supportedValuesOf === 'function' ? Intl.supportedValuesOf('timeZone') : []\n\t} catch {\n\t\tcodes = []\n\t}\n\tif (!codes.length) {\n\t\tcodes = FALLBACK_TIMEZONES\n\t}\n\tif (!codes.includes('UTC')) {\n\t\tcodes = ['UTC', ...codes]\n\t}\n\tconst labels = {}\n\tfor (const code of codes) {\n\t\tlabels[code] = code.replace(/_/g, ' ')\n\t}\n\ttimezoneCache = { codes: [...codes], labels }\n\treturn timezoneCache\n}\n\n/**\n * Fit a language tag to the property's `pattern`, if it has one.\n *\n * A schema that stores ISO 639-1 (`^[a-z]{2}$`) cannot take `en-GB`, so the\n * tag falls back to its primary subtag. Without a pattern the full tag stays.\n *\n * @param {string} tag A BCP 47 tag.\n * @param {string|undefined} pattern The property's `pattern`.\n * @return {string} The tag as the schema accepts it.\n */\nfunction fitLanguageTag(tag, pattern) {\n\tif (!pattern) {\n\t\treturn tag\n\t}\n\tlet re\n\ttry {\n\t\tre = new RegExp(pattern)\n\t} catch {\n\t\treturn tag\n\t}\n\tif (re.test(tag)) {\n\t\treturn tag\n\t}\n\tconst primary = tag.split('-')[0].toLowerCase()\n\treturn re.test(primary) ? primary : tag\n}\n\n/**\n * Resolve an `x-default` token to the value a NEW object starts with.\n *\n * - `current-language`: the user's Nextcloud language (BCP 47, fitted to the\n *   property's `pattern`).\n * - `current-timezone`: the browser's time zone.\n *\n * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md\n * @param {string|null} token The `x-default` value.\n * @param {object} [field] The field descriptor (reads `validation.pattern`).\n * @return {string|null} The value, or null for an unknown token.\n */\nexport function resolveDefaultToken(token, field = {}) {\n\tif (token === 'current-language') {\n\t\tconst pattern = field && field.validation ? field.validation.pattern : undefined\n\t\treturn fitLanguageTag(currentLanguageTag(), pattern)\n\t}\n\tif (token === 'current-timezone') {\n\t\treturn currentTimezone()\n\t}\n\treturn null\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/schema.js

@@ -298,10 +298,13 @@ function truncateString(str, maxLength) {
  *    surface (CnFormDialog) resolves the reference to a searchable dropdown
  *    of the referenced objects (label = human name, value = UUID).
  * 4. Nextcloud user reference: `referenceType: 'nextcloud-user'` (or
- *    `format: 'user'`/`'username'`) → `'user'`; an array of such
+ *    `format: 'user'`/`'username'`/`'nc-user'`) → `'user'`; an array of such
  *    properties → `'user-multiselect'`. CnFormDialog resolves these to a
  *    searchable dropdown of real Nextcloud users (label = display name,
- *    value = UID).
+ *    value = UID). A Nextcloud group (`referenceType: 'nextcloud-group'` or
+ *    `format: 'nc-group'`) → `'group'`, an array of groups →
+ *    `'group-multiselect'`. `format: 'language'` → `'language'` and
+ *    `format: 'timezone'` → `'timezone'` (both searchable code lists).
  * 5. Type-based: `boolean` → `'checkbox'`, `integer`/`number` → `'number'`,
  *    `array` + `items.enum` → `'multiselect'`, `array` → `'tags'`
  * 6. Format-based: `date-time` → `'datetime'`, `date` → `'date'`,
@@ -369,9 +372,32 @@ function isUserProp(prop) {
 		return true
 	}
 	const format = prop.format || '';
-	return format === 'user' || format === 'username'
+	return format === 'user' || format === 'username' || format === 'nc-user'
 }
 
+/**
+ * Whether a (single-value) schema property represents a Nextcloud group.
+ *
+ * A property is a group field when it declares `referenceType: 'nextcloud-group'`
+ * or `format: 'nc-group'`. CnFormDialog renders it as a searchable dropdown of
+ * Nextcloud groups (label = display name, value = group id).
+ *
+ * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md
+ * @param {object} prop A schema property definition (or `items` for an array).
+ * @return {boolean} True when the property marks a Nextcloud group.
+ */
+function isGroupProp(prop) {
+	if (!prop || typeof prop !== 'object') {
+		return false
+	}
+	return prop.referenceType === 'nextcloud-group' || prop.format === 'nc-group'
+}
+
+/**
+ * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md
+ * @param {object} prop The schema property definition.
+ * @return {string} The widget identifier (see the block above).
+ */
 function resolveWidget(prop) {
 	// Explicit widget hint takes priority
 	if (prop.widget) {
@@ -410,6 +436,24 @@ function resolveWidget(prop) {
 		return 'user-multiselect'
 	}
 
+	// Nextcloud group (`format: 'nc-group'` / `referenceType: 'nextcloud-group'`):
+	// a searchable dropdown of groups storing the group id.
+	if (isGroupProp(prop)) {
+		return 'group'
+	}
+	if (type === 'array' && isGroupProp(prop.items)) {
+		return 'group-multiselect'
+	}
+
+	// Language and time zone codes: a searchable list instead of a free-text
+	// box, so a person picks "Dutch" and the record stores `nl`.
+	if (type === 'string' && format === 'language') {
+		return 'language'
+	}
+	if (type === 'string' && format === 'timezone') {
+		return 'timezone'
+	}
+
 	// Boolean → switch/checkbox
 	if (type === 'boolean') {
 		return 'checkbox'
@@ -588,7 +632,8 @@ function isTenantProperty(key, prop) {
  * @param {boolean} [options.includeReadOnly] Whether to include readOnly properties
  * @param {boolean} [options.hideTenant] Drop properties that hold the record's tenant (see `isTenantProperty`). Off by default, so a detail page still shows the tenant; CnFormDialog turns it on because nobody should be asked for it. `overrides[key].hidden === false` keeps one visible.
  * @param {(text: string) => string} [options.translate] Optional display-layer translation function applied to each field's `label` and `description`. Schema property titles/descriptions are authored in English as the canonical source; consumers pass their bound `t()` (via the injected `cnTranslate`) so the rendered field label follows the user's language. When omitted, label/description are the English source strings unchanged (pure, backward-compatible).
- * @return {Array<{key: string, label: string, description: string, descriptionLong: string, type: string, format: string|null, widget: string, required: boolean, readOnly: boolean, default: unknown, enum: Array|null, enumLabels: object|null, items: object|null, referenceType: string|null, referenceSemanticType: string|null, referenceSemanticApp: string|null, reference: {schema: string|number, multiple: boolean}|null, userPicker: {multiple: boolean}|null, fillFrom: object|null, validation: object, order: number}>} `description` is the inline helper text (see `splitDescription`); `descriptionLong` carries the full text when it was too long to render inline, else ''. `enumLabels` maps each raw enum value to its English display label (from the property's `x-enum-labels`), or null.
+ * @spec openspec/changes/form-pickers-from-schema/specs/schema-utilities/spec.md
+ * @return {Array<{key: string, label: string, description: string, descriptionLong: string, type: string, format: string|null, widget: string, required: boolean, readOnly: boolean, default: unknown, enum: Array|null, enumLabels: object|null, items: object|null, referenceType: string|null, referenceSemanticType: string|null, referenceSemanticApp: string|null, reference: {schema: string|number, multiple: boolean, register?: string, labelField?: string}|null, allowCreate: boolean, userPicker: {multiple: boolean}|null, groupPicker: {multiple: boolean}|null, defaultToken: string|null, fillFrom: object|null, validation: object, order: number}>} `description` is the inline helper text (see `splitDescription`); `descriptionLong` carries the property's `x-help` text when it declares one, else the full description when it was too long to render inline, else ''. `enumLabels` maps each raw enum value to its English display label (from the property's `x-enum-labels`), or null.
  */
 function fieldsFromSchema(schema, options = {}) {
 	const { exclude = [], include = null, overrides = {}, includeReadOnly = false, hideTenant = false, translate } = options;
@@ -664,11 +709,19 @@ function fieldsFromSchema(schema, options = {}) {
 
 	return entries.map(([key, prop]) => {
 		const description = splitDescription(prop.description ? tr(prop.description) : '');
+		// `x-help` is the long explanation behind the (i) popover. It always
+		// shows the popover, while `description` stays the short helper line.
+		const help = typeof prop['x-help'] === 'string' && prop['x-help'].trim() !== ''
+			? tr(prop['x-help'].trim())
+			: '';
+		const labelField = prop['x-label-field']
+			|| (prop.items && prop.items['x-label-field'])
+			|| null;
 		const field = {
 			key,
 			label: tr(prop.title || key),
 			description: description.short,
-			descriptionLong: description.long,
+			descriptionLong: help || description.long,
 			type: prop.type || 'string',
 			format: prop.format || null,
 			widget: resolveWidget(prop),
@@ -686,6 +739,10 @@ function fieldsFromSchema(schema, options = {}) {
 			required: requiredKeys.includes(key),
 			readOnly: prop.readOnly || false,
 			default: prop.default !== undefined ? prop.default : null,
+			// A default that depends on who opens the form (`x-default:
+			// 'current-language'` / `'current-timezone'`). Resolved by the
+			// consuming form on a NEW object only; never on edit.
+			defaultToken: typeof prop['x-default'] === 'string' ? prop['x-default'] : null,
 			enum: prop.enum || null,
 			// Display labels for the enum CODES, keyed by raw value. An enum
 			// value is a stored contract value, not display text — several are
@@ -733,11 +790,23 @@ function fieldsFromSchema(schema, options = {}) {
 			// form's own; absent, the reference stays same-register (the form's
 			// `register` prop is used). Consolidates the ad-hoc caseReference /
 			// approvalDecisionId / x-mirror-of variants onto one convention.
+			//
+			// `x-label-field` names the referenced object's property that labels
+			// an option and that an inline create writes the typed term to
+			// (`reference.labelField`, default `name` at the consumer).
 			reference: (normalizeRef(prop.$ref) !== null)
-				? { schema: normalizeRef(prop.$ref), multiple: false, ...(prop['x-external-register'] ? { register: prop['x-external-register'] } : {}) }
+				? { schema: normalizeRef(prop.$ref), multiple: false, ...(prop['x-external-register'] ? { register: prop['x-external-register'] } : {}), ...(labelField ? { labelField } : {}) }
 				: (prop.type === 'array' && prop.items && normalizeRef(prop.items.$ref) !== null)
-						? { schema: normalizeRef(prop.items.$ref), multiple: true, ...((prop.items['x-external-register'] || prop['x-external-register']) ? { register: prop.items['x-external-register'] || prop['x-external-register'] } : {}) }
+						? { schema: normalizeRef(prop.items.$ref), multiple: true, ...((prop.items['x-external-register'] || prop['x-external-register']) ? { register: prop.items['x-external-register'] || prop['x-external-register'] } : {}), ...(labelField ? { labelField } : {}) }
 						: null,
+			// Select OR create (`x-allow-create: true`, on the property or on
+			// its `items` for an array): the picker offers "Create" next to the
+			// existing objects. Only meaningful on a reference.
+			allowCreate: prop['x-allow-create'] === true
+				|| (prop.type === 'array' && !!prop.items && prop.items['x-allow-create'] === true),
+			// Template copy (`x-fill-from: { formKey: sourceKey }`): choosing a
+			// referenced object copies those of its values into this form.
+			fillFrom: (prop['x-fill-from'] && typeof prop['x-fill-from'] === 'object') ? prop['x-fill-from'] : null,
 			// Nextcloud user reference: when a property marks a NC user
 			// (`referenceType: 'nextcloud-user'`, or `format: 'user'`/
 			// `'username'`), tag it so CnFormDialog renders a searchable
@@ -750,6 +819,13 @@ function fieldsFromSchema(schema, options = {}) {
 				: (prop.type === 'array' && isUserProp(prop.items))
 						? { multiple: true }
 						: null,
+			// Nextcloud group reference (`format: 'nc-group'` or
+			// `referenceType: 'nextcloud-group'`): the form stores the group id.
+			groupPicker: isGroupProp(prop)
+				? { multiple: false }
+				: (prop.type === 'array' && isGroupProp(prop.items))
+						? { multiple: true }
+						: null,
 			// Conditional immutability (AD: x-openregister-readonly-when): a
 			// property can declare it becomes read-only when another field on the
 			// same object holds a given value — e.g. a hybrid app's identity