@conduction/nextcloud-vue 2.146.0 → 2.148.0

package/src/utils/builtInFormatters.js

@@ -524,6 +524,57 @@ export function formatIsoDuration(value) {
 	return words[period.unit] ? words[period.unit]() : String(value)
 }
 
+/** The ISO designator of each date unit a term is written in. */
+const UNIT_DESIGNATOR = { years: 'Y', months: 'M', weeks: 'W', days: 'D' }
+
+/**
+ * A one-unit ISO-8601 period, a day count that is whole weeks read as weeks
+ * (a term of `P28D` is "4 weeks"); null when it is not a one-unit period.
+ *
+ * @param {unknown} value The stored period.
+ * @return {{amount: number, unit: string}|null}
+ */
+function termPeriod(value) {
+	if (value === null || value === undefined || value === '') {
+		return null
+	}
+	const period = parseDuration(String(value))
+	if (period === null || !UNIT_DESIGNATOR[period.unit]) {
+		return null
+	}
+	if (period.unit === 'days' && period.amount > 0 && period.amount % 7 === 0) {
+		return { amount: period.amount / 7, unit: 'weeks' }
+	}
+	return period
+}
+
+/**
+ * A term in words, with the extension it may get (`format: 'duration'`):
+ * `P28D` reads "4 weeks", and with an extension of `P14D` "4 weeks,
+ * extendable by 2" (the unit is said once when both share it). A value that
+ * is not a one-unit period is returned as written, '' for null or empty.
+ *
+ * @spec openspec/changes/data-widget-duration-format/specs/data-widget/spec.md#requirement-a-term-reads-in-words-with-its-extension
+ * @param {unknown} value The stored term.
+ * @param {unknown} [extension] The stored extension period, if any.
+ * @return {string}
+ */
+export function formatTermDuration(value, extension = null) {
+	const term = termPeriod(value)
+	if (term === null) {
+		return value === null || value === undefined ? '' : String(value)
+	}
+	const words = formatIsoDuration(`P${term.amount}${UNIT_DESIGNATOR[term.unit]}`)
+	const extra = termPeriod(extension)
+	if (extra === null || extra.amount === 0) {
+		return words
+	}
+	const extraWords = extra.unit === term.unit
+		? String(extra.amount)
+		: formatIsoDuration(`P${extra.amount}${UNIT_DESIGNATOR[extra.unit]}`)
+	return t('nextcloud-vue', '{term}, extendable by {extension}', { term: words, extension: extraWords })
+}
+
 /**
  * A Nextcloud user id as its display name (`userName` registry key): the id
  * while the name is looked up, and for a user nobody answers for.
@@ -553,6 +604,7 @@ export const BUILT_IN_FORMATTERS = {
 	connectionSettingsLabel: formatConnectionSettingsLabel,
 	masked: formatMasked,
 	isoDuration: formatIsoDuration,
+	termDuration: formatTermDuration,
 	valueMap: formatValueMap,
 	userName: formatUserName,
 }

package/src/utils/objectParties.js

@@ -176,6 +176,35 @@ export function kindCode(kind) {
 	return String(kind?.code || kind?.key || '')
 }
 
+/**
+ * Whether a party's kind is among the kinds a record accepts. Two
+ * vocabularies meet here: the party's kind is its schema's (`person`,
+ * `organisation`, `colleague`), while the accepted kinds may be role kinds
+ * that name the identity shapes they take (pipelinq's `aanvrager` with
+ * `identityShapes: ["naturalPerson", "organization"]`). When the accepted
+ * kinds name shapes, the party's own kind is matched by the shapes the
+ * listing gives it; a kind that names none cannot be judged and passes.
+ * Otherwise the codes are compared.
+ *
+ * @param {string} partyKind The party's kind key.
+ * @param {Array<object>} accepted The accepted kinds.
+ * @param {Array<object>} own The listing's own kinds (`{ key, identityShapes? }`).
+ * @return {boolean} False only when the party is known not to fit.
+ * @spec openspec/changes/parties-accepted-kinds-by-shape/specs/object-parties/spec.md#requirement-a-party-is-checked-against-the-accepted-kinds-in-one-vocabulary
+ */
+export function partyKindAccepted(partyKind, accepted, own) {
+	const kinds = Array.isArray(accepted) ? accepted : []
+	const shapes = new Set(kinds.flatMap((kind) => (Array.isArray(kind?.identityShapes) ? kind.identityShapes : [])))
+	if (shapes.size === 0) {
+		return kinds.some((kind) => kindCode(kind) === partyKind)
+	}
+	const mine = (Array.isArray(own) ? own : []).find((kind) => kindCode(kind) === partyKind)?.identityShapes
+	if (!Array.isArray(mine) || mine.length === 0) {
+		return true
+	}
+	return mine.some((shape) => shapes.has(shape))
+}
+
 /**
  * Write a value at a dotted path, creating the objects on the way.
  *