@conduction/nextcloud-vue 2.59.0 → 2.61.0

package/dist/esm/utils/dateVariant.js

@@ -0,0 +1,124 @@
+import { compareVisibleWhen } from './visibleWhen.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * dateVariant: turn "how far away is this date" into a colour variant.
+ *
+ * A deadline reads differently depending on how close it is. The rules are the
+ * `variantWhen` shape the stat tile already uses (`[{ op, value, variant }]`,
+ * first match wins), compared against the number of CALENDAR days from today
+ * until the date: `0` is today, a negative number is overdue.
+ *
+ * ```js
+ * resolveDateVariant('2026-10-01', [
+ *   { op: 'lt', value: 0, variant: 'error' },     // overdue
+ *   { op: 'lte', value: 5, variant: 'warning' },  // within five days
+ * ])
+ * ```
+ *
+ * Shared by the `date` cell widget (CnCellRenderer) and the week strip, and
+ * meant for board cards too, so a deadline is coloured by one rule everywhere.
+ *
+ * @module utils/dateVariant
+ */
+
+
+/** Variants a date rule may name. `danger` is accepted as an alias of `error`. */
+const DATE_VARIANTS = Object.freeze(['default', 'success', 'warning', 'error']);
+
+const MS_PER_DAY = 86400000;
+
+/**
+ * Parse a value into a Date. A date-only string (`2026-10-05`) is read as a
+ * LOCAL day, so it does not slide to the day before in a timezone west of UTC.
+ *
+ * @param {unknown} value A Date, a timestamp, or an ISO string.
+ * @return {Date|null} The date, or null when the value is not one.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells
+ */
+function parseDateValue(value) {
+	if (value === null || value === undefined || value === '') {
+		return null
+	}
+	if (value instanceof Date) {
+		return Number.isNaN(value.getTime()) ? null : value
+	}
+	if (typeof value === 'string') {
+		const dateOnly = value.match(/^(\d{4})-(\d{2})-(\d{2})$/);
+		if (dateOnly) {
+			return new Date(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]))
+		}
+	}
+	if (typeof value !== 'string' && typeof value !== 'number') {
+		return null
+	}
+	const parsed = new Date(value);
+	return Number.isNaN(parsed.getTime()) ? null : parsed
+}
+
+/**
+ * The local calendar day of a date as `YYYY-MM-DD`.
+ *
+ * @param {Date} date The date.
+ * @return {string} The day key.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-week-strip-widget
+ */
+function dayKey(date) {
+	const month = String(date.getMonth() + 1).padStart(2, '0');
+	const day = String(date.getDate()).padStart(2, '0');
+	return `${date.getFullYear()}-${month}-${day}`
+}
+
+/**
+ * Whole calendar days from `now` until `value`: 0 today, negative when past.
+ *
+ * @param {unknown} value The date.
+ * @param {Date} [now] The reference moment (defaults to the current time).
+ * @return {number|null} The day count, or null when `value` is not a date.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells
+ */
+function daysUntil(value, now = new Date()) {
+	const date = parseDateValue(value);
+	if (date === null) {
+		return null
+	}
+	// UTC midnights of the two LOCAL days, so a daylight-saving hour never
+	// turns one day into zero or two.
+	const target = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate());
+	const today = Date.UTC(now.getFullYear(), now.getMonth(), now.getDate());
+	return Math.round((target - today) / MS_PER_DAY)
+}
+
+/**
+ * The variant of the first rule the date matches, or '' when none does.
+ *
+ * @param {unknown} value The date.
+ * @param {Array<{op: string, value: number, variant: string}>} rules The `variantWhen` rules.
+ * @param {Date} [now] The reference moment (defaults to the current time).
+ * @return {string} `success | warning | error | default`, or '' for no match.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells
+ */
+function resolveDateVariant(value, rules, now = new Date()) {
+	if (!Array.isArray(rules) || rules.length === 0) {
+		return ''
+	}
+	const days = daysUntil(value, now);
+	if (days === null) {
+		return ''
+	}
+	for (const rule of rules) {
+		if (!rule || typeof rule !== 'object') {
+			continue
+		}
+		if (compareVisibleWhen(days, rule.op || 'eq', rule.value) === true) {
+			const variant = rule.variant === 'danger' ? 'error' : rule.variant;
+			return DATE_VARIANTS.includes(variant) ? variant : ''
+		}
+	}
+	return ''
+}
+
+export { DATE_VARIANTS, dayKey, daysUntil, parseDateValue, resolveDateVariant };
+//# sourceMappingURL=dateVariant.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dateVariant.js","sources":["../../../src/utils/dateVariant.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * dateVariant: turn \"how far away is this date\" into a colour variant.\n *\n * A deadline reads differently depending on how close it is. The rules are the\n * `variantWhen` shape the stat tile already uses (`[{ op, value, variant }]`,\n * first match wins), compared against the number of CALENDAR days from today\n * until the date: `0` is today, a negative number is overdue.\n *\n * ```js\n * resolveDateVariant('2026-10-01', [\n *   { op: 'lt', value: 0, variant: 'error' },     // overdue\n *   { op: 'lte', value: 5, variant: 'warning' },  // within five days\n * ])\n * ```\n *\n * Shared by the `date` cell widget (CnCellRenderer) and the week strip, and\n * meant for board cards too, so a deadline is coloured by one rule everywhere.\n *\n * @module utils/dateVariant\n */\n\nimport { compareVisibleWhen } from './visibleWhen.js'\n\n/** Variants a date rule may name. `danger` is accepted as an alias of `error`. */\nexport const DATE_VARIANTS = Object.freeze(['default', 'success', 'warning', 'error'])\n\nconst MS_PER_DAY = 86400000\n\n/**\n * Parse a value into a Date. A date-only string (`2026-10-05`) is read as a\n * LOCAL day, so it does not slide to the day before in a timezone west of UTC.\n *\n * @param {unknown} value A Date, a timestamp, or an ISO string.\n * @return {Date|null} The date, or null when the value is not one.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells\n */\nexport function parseDateValue(value) {\n\tif (value === null || value === undefined || value === '') {\n\t\treturn null\n\t}\n\tif (value instanceof Date) {\n\t\treturn Number.isNaN(value.getTime()) ? null : value\n\t}\n\tif (typeof value === 'string') {\n\t\tconst dateOnly = value.match(/^(\\d{4})-(\\d{2})-(\\d{2})$/)\n\t\tif (dateOnly) {\n\t\t\treturn new Date(Number(dateOnly[1]), Number(dateOnly[2]) - 1, Number(dateOnly[3]))\n\t\t}\n\t}\n\tif (typeof value !== 'string' && typeof value !== 'number') {\n\t\treturn null\n\t}\n\tconst parsed = new Date(value)\n\treturn Number.isNaN(parsed.getTime()) ? null : parsed\n}\n\n/**\n * The local calendar day of a date as `YYYY-MM-DD`.\n *\n * @param {Date} date The date.\n * @return {string} The day key.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-week-strip-widget\n */\nexport function dayKey(date) {\n\tconst month = String(date.getMonth() + 1).padStart(2, '0')\n\tconst day = String(date.getDate()).padStart(2, '0')\n\treturn `${date.getFullYear()}-${month}-${day}`\n}\n\n/**\n * Whole calendar days from `now` until `value`: 0 today, negative when past.\n *\n * @param {unknown} value The date.\n * @param {Date} [now] The reference moment (defaults to the current time).\n * @return {number|null} The day count, or null when `value` is not a date.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells\n */\nexport function daysUntil(value, now = new Date()) {\n\tconst date = parseDateValue(value)\n\tif (date === null) {\n\t\treturn null\n\t}\n\t// UTC midnights of the two LOCAL days, so a daylight-saving hour never\n\t// turns one day into zero or two.\n\tconst target = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate())\n\tconst today = Date.UTC(now.getFullYear(), now.getMonth(), now.getDate())\n\treturn Math.round((target - today) / MS_PER_DAY)\n}\n\n/**\n * The variant of the first rule the date matches, or '' when none does.\n *\n * @param {unknown} value The date.\n * @param {Array<{op: string, value: number, variant: string}>} rules The `variantWhen` rules.\n * @param {Date} [now] The reference moment (defaults to the current time).\n * @return {string} `success | warning | error | default`, or '' for no match.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-avatar-and-date-cells\n */\nexport function resolveDateVariant(value, rules, now = new Date()) {\n\tif (!Array.isArray(rules) || rules.length === 0) {\n\t\treturn ''\n\t}\n\tconst days = daysUntil(value, now)\n\tif (days === null) {\n\t\treturn ''\n\t}\n\tfor (const rule of rules) {\n\t\tif (!rule || typeof rule !== 'object') {\n\t\t\tcontinue\n\t\t}\n\t\tif (compareVisibleWhen(days, rule.op || 'eq', rule.value) === true) {\n\t\t\tconst variant = rule.variant === 'danger' ? 'error' : rule.variant\n\t\t\treturn DATE_VARIANTS.includes(variant) ? variant : ''\n\t\t}\n\t}\n\treturn ''\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/detailActionModel.js

@@ -0,0 +1,260 @@
+import { readPath } from './readPath.js';
+import { evaluateVisibleWhenLocal } from './visibleWhen.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * detailActionModel: the rules behind a detail page's four action levels and
+ * the case surfaces that read the record's stage.
+ *
+ *   1. the next step: one primary button, chosen by the record's stage,
+ *   2. quick actions: at most three always visible buttons,
+ *   3. the overflow menu: the rest, in named groups,
+ *   4. admin actions: the last group, for admins only.
+ *
+ * Pure functions, no Vue and no fetch, so CnDetailPage, the widgets and the
+ * tests all read one implementation.
+ *
+ * @module utils/detailActionModel
+ */
+
+
+/** The most quick actions a page shows. Later entries are dropped. */
+const MAX_QUICK_ACTIONS = 3;
+
+/**
+ * The record's stage, as the string a stage map is keyed on.
+ *
+ * @param {object|null} object The record.
+ * @param {string} [stageField] Dot-path to the stage. Defaults to `status`.
+ * @return {string} The stage, or '' when the record has none.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-primary-action-follows-the-stage
+ */
+function stageOf(object, stageField = 'status') {
+	if (!object || typeof object !== 'object') {
+		return ''
+	}
+	const value = readPath(object, stageField || 'status');
+	if (value === null || value === undefined || typeof value === 'object') {
+		return ''
+	}
+	return String(value)
+}
+
+/**
+ * Look a stage up in a stage-keyed map. An exact key wins; otherwise the
+ * match ignores case, because a status is stored as `in_behandeling` in one
+ * register and `In_Behandeling` in the next.
+ *
+ * @param {object|null} map The stage-keyed map.
+ * @param {string} stage The stage.
+ * @return {unknown} The entry, or undefined.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-primary-action-follows-the-stage
+ */
+function stageEntry(map, stage) {
+	if (!map || typeof map !== 'object' || Array.isArray(map) || stage === '') {
+		return undefined
+	}
+	if (Object.hasOwn(map, stage)) {
+		return map[stage]
+	}
+	const wanted = stage.toLowerCase();
+	const key = Object.keys(map).find((candidate) => candidate.toLowerCase() === wanted);
+	return key === undefined ? undefined : map[key]
+}
+
+/**
+ * Turn a pinned action entry into a descriptor the page can dispatch.
+ *
+ * An entry is the id of a declared header action, or an action object of its
+ * own. An object without an id gets `fallbackId`, since every dispatched
+ * action is addressed by id.
+ *
+ * @param {string|object|null} entry The entry.
+ * @param {string} fallbackId Id for an inline action that names none.
+ * @return {{id: string, inline: object|null}|null} The id, plus the inline definition when the entry carried one.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-quick-actions
+ */
+function normalisePinnedAction(entry, fallbackId) {
+	if (typeof entry === 'string') {
+		return entry === '' ? null : { id: entry, inline: null }
+	}
+	if (!entry || typeof entry !== 'object' || Array.isArray(entry)) {
+		return null
+	}
+	if (typeof entry.label !== 'string' || entry.label === '') {
+		return null
+	}
+	const id = typeof entry.id === 'string' && entry.id !== '' ? entry.id : fallbackId;
+	return { id, inline: { ...entry, id } }
+}
+
+/**
+ * Split menu entries into the groups the overflow menu draws.
+ *
+ * Ungrouped entries come first, under no caption. Named groups follow in the
+ * order they first appear. Admin only entries are dropped for everyone else
+ * and form the last group for admins, whatever `group` they also name.
+ *
+ * `adminOnly` hides a control. It is never an authorization decision: the
+ * endpoint behind the action decides who may call it.
+ *
+ * @param {Array<object>} entries Menu-ready entries, each with an `id`.
+ * @param {object} actionsById The declared actions by id, carrying `group` / `adminOnly`.
+ * @param {{isAdmin?: boolean, adminLabel?: string}} [options] Who is looking, and what the admin group is called.
+ * @return {Array<{key: string, label: string, entries: Array<object>}>} The non-empty groups, in render order.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-grouped-and-admin-only-menu-actions
+ */
+function groupMenuEntries(entries, actionsById = {}, options = {}) {
+	const isAdmin = options.isAdmin === true;
+	const plain = { key: '', label: '', entries: [] };
+	const named = [];
+	const admin = { key: 'cn-admin', label: options.adminLabel || '', entries: [] };
+	for (const entry of Array.isArray(entries) ? entries : []) {
+		const declared = (entry && actionsById[entry.id]) || {};
+		if (declared.adminOnly === true) {
+			if (isAdmin) {
+				admin.entries.push(entry);
+			}
+			continue
+		}
+		const label = typeof declared.group === 'string' ? declared.group.trim() : '';
+		if (label === '') {
+			plain.entries.push(entry);
+			continue
+		}
+		let group = named.find((candidate) => candidate.label === label);
+		if (!group) {
+			group = { key: `cn-group-${named.length}`, label, entries: [] };
+			named.push(group);
+		}
+		group.entries.push(entry);
+	}
+	return [plain, ...named, admin].filter((group) => group.entries.length > 0)
+}
+
+/**
+ * Whether one checklist item is done for this record.
+ *
+ * `done` (a literal) wins, then `doneWhen` (a local visibleWhen condition),
+ * then `doneField` (truthy, and for a list: not empty).
+ *
+ * @param {object} item The checklist item.
+ * @param {object|null} object The record.
+ * @return {boolean} True when the item is done.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-next-step-card
+ */
+function isChecklistItemDone(item, object) {
+	if (!item || typeof item !== 'object') {
+		return false
+	}
+	if (typeof item.done === 'boolean') {
+		return item.done
+	}
+	const data = object && typeof object === 'object' ? object : {};
+	if (item.doneWhen && typeof item.doneWhen === 'object') {
+		return evaluateVisibleWhenLocal(item.doneWhen, data)
+	}
+	if (typeof item.doneField === 'string' && item.doneField !== '') {
+		const value = readPath(data, item.doneField);
+		return Array.isArray(value) ? value.length > 0 : Boolean(value)
+	}
+	return false
+}
+
+/**
+ * Resolve the "what now" card for the record's stage.
+ *
+ * @param {{stages?: object, title?: string}|null} config The `nextStep` config.
+ * @param {object|null} object The record.
+ * @param {string} [stageField] Dot-path to the stage.
+ * @return {{stage: string, title: string, items: Array<{label: string, done: boolean, hint: string}>, after: string}|null} The card, or null when this stage declares no checklist.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-next-step-card
+ */
+function resolveNextStep(config, object, stageField = 'status') {
+	if (!config || typeof config !== 'object') {
+		return null
+	}
+	const stage = stageOf(object, config.field || stageField);
+	const declared = stageEntry(config.stages, stage);
+	if (!declared || typeof declared !== 'object' || !Array.isArray(declared.checklist)) {
+		return null
+	}
+	const items = declared.checklist
+		.filter((item) => item && typeof item === 'object' && typeof item.label === 'string' && item.label !== '')
+		.map((item) => ({
+			label: item.label,
+			done: isChecklistItemDone(item, object),
+			hint: typeof item.hint === 'string' ? item.hint : '',
+		}));
+	if (items.length === 0) {
+		return null
+	}
+	return {
+		stage,
+		title: typeof declared.title === 'string' ? declared.title : (typeof config.title === 'string' ? config.title : ''),
+		items,
+		after: typeof declared.after === 'string' ? declared.after : '',
+	}
+}
+
+/**
+ * Resolve a header pill from the record.
+ *
+ * @param {{field?: string, colorMap?: object, labels?: object, variant?: string}|null} config The pill config.
+ * @param {object|null} object The record.
+ * @return {{label: string, colorKey: string, colorMap: object|null, variant: string}|null} What CnStatusBadge needs, or null when the field is empty.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-header-pills
+ */
+function resolvePill(config, object) {
+	if (!config || typeof config !== 'object' || typeof config.field !== 'string' || config.field === '') {
+		return null
+	}
+	const raw = stageOf(object, config.field);
+	if (raw === '') {
+		return null
+	}
+	const mapped = stageEntry(config.labels, raw);
+	return {
+		label: typeof mapped === 'string' && mapped !== '' ? mapped : raw,
+		colorKey: raw,
+		colorMap: config.colorMap && typeof config.colorMap === 'object' ? config.colorMap : null,
+		variant: typeof config.variant === 'string' && config.variant !== '' ? config.variant : 'default',
+	}
+}
+
+/**
+ * Resolve a tab's count.
+ *
+ * `count` (a number) wins. Otherwise `countField` is read off the record: a
+ * list counts its items, a number is taken as is.
+ *
+ * @param {{count?: number, countField?: string}|null} tab The tab declaration.
+ * @param {object|null} object The record.
+ * @return {number|null} The count, or null when the tab declares none.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-tab-counts-and-overflow
+ */
+function resolveTabCount(tab, object) {
+	if (!tab || typeof tab !== 'object') {
+		return null
+	}
+	if (typeof tab.count === 'number' && Number.isFinite(tab.count)) {
+		return tab.count
+	}
+	if (typeof tab.countField !== 'string' || tab.countField === '') {
+		return null
+	}
+	const value = readPath(object && typeof object === 'object' ? object : {}, tab.countField);
+	if (Array.isArray(value)) {
+		return value.length
+	}
+	if (value === null || value === undefined || value === '') {
+		return 0
+	}
+	const number = Number(value);
+	return Number.isFinite(number) ? number : null
+}
+
+export { MAX_QUICK_ACTIONS, groupMenuEntries, isChecklistItemDone, normalisePinnedAction, resolveNextStep, resolvePill, resolveTabCount, stageEntry, stageOf };
+//# sourceMappingURL=detailActionModel.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"detailActionModel.js","sources":["../../../src/utils/detailActionModel.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * detailActionModel: the rules behind a detail page's four action levels and\n * the case surfaces that read the record's stage.\n *\n *   1. the next step: one primary button, chosen by the record's stage,\n *   2. quick actions: at most three always visible buttons,\n *   3. the overflow menu: the rest, in named groups,\n *   4. admin actions: the last group, for admins only.\n *\n * Pure functions, no Vue and no fetch, so CnDetailPage, the widgets and the\n * tests all read one implementation.\n *\n * @module utils/detailActionModel\n */\n\nimport { readPath } from './readPath.js'\nimport { evaluateVisibleWhenLocal } from './visibleWhen.js'\n\n/** The most quick actions a page shows. Later entries are dropped. */\nexport const MAX_QUICK_ACTIONS = 3\n\n/**\n * The record's stage, as the string a stage map is keyed on.\n *\n * @param {object|null} object The record.\n * @param {string} [stageField] Dot-path to the stage. Defaults to `status`.\n * @return {string} The stage, or '' when the record has none.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-primary-action-follows-the-stage\n */\nexport function stageOf(object, stageField = 'status') {\n\tif (!object || typeof object !== 'object') {\n\t\treturn ''\n\t}\n\tconst value = readPath(object, stageField || 'status')\n\tif (value === null || value === undefined || typeof value === 'object') {\n\t\treturn ''\n\t}\n\treturn String(value)\n}\n\n/**\n * Look a stage up in a stage-keyed map. An exact key wins; otherwise the\n * match ignores case, because a status is stored as `in_behandeling` in one\n * register and `In_Behandeling` in the next.\n *\n * @param {object|null} map The stage-keyed map.\n * @param {string} stage The stage.\n * @return {unknown} The entry, or undefined.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-primary-action-follows-the-stage\n */\nexport function stageEntry(map, stage) {\n\tif (!map || typeof map !== 'object' || Array.isArray(map) || stage === '') {\n\t\treturn undefined\n\t}\n\tif (Object.hasOwn(map, stage)) {\n\t\treturn map[stage]\n\t}\n\tconst wanted = stage.toLowerCase()\n\tconst key = Object.keys(map).find((candidate) => candidate.toLowerCase() === wanted)\n\treturn key === undefined ? undefined : map[key]\n}\n\n/**\n * Turn a pinned action entry into a descriptor the page can dispatch.\n *\n * An entry is the id of a declared header action, or an action object of its\n * own. An object without an id gets `fallbackId`, since every dispatched\n * action is addressed by id.\n *\n * @param {string|object|null} entry The entry.\n * @param {string} fallbackId Id for an inline action that names none.\n * @return {{id: string, inline: object|null}|null} The id, plus the inline definition when the entry carried one.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-quick-actions\n */\nexport function normalisePinnedAction(entry, fallbackId) {\n\tif (typeof entry === 'string') {\n\t\treturn entry === '' ? null : { id: entry, inline: null }\n\t}\n\tif (!entry || typeof entry !== 'object' || Array.isArray(entry)) {\n\t\treturn null\n\t}\n\tif (typeof entry.label !== 'string' || entry.label === '') {\n\t\treturn null\n\t}\n\tconst id = typeof entry.id === 'string' && entry.id !== '' ? entry.id : fallbackId\n\treturn { id, inline: { ...entry, id } }\n}\n\n/**\n * Split menu entries into the groups the overflow menu draws.\n *\n * Ungrouped entries come first, under no caption. Named groups follow in the\n * order they first appear. Admin only entries are dropped for everyone else\n * and form the last group for admins, whatever `group` they also name.\n *\n * `adminOnly` hides a control. It is never an authorization decision: the\n * endpoint behind the action decides who may call it.\n *\n * @param {Array<object>} entries Menu-ready entries, each with an `id`.\n * @param {object} actionsById The declared actions by id, carrying `group` / `adminOnly`.\n * @param {{isAdmin?: boolean, adminLabel?: string}} [options] Who is looking, and what the admin group is called.\n * @return {Array<{key: string, label: string, entries: Array<object>}>} The non-empty groups, in render order.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-grouped-and-admin-only-menu-actions\n */\nexport function groupMenuEntries(entries, actionsById = {}, options = {}) {\n\tconst isAdmin = options.isAdmin === true\n\tconst plain = { key: '', label: '', entries: [] }\n\tconst named = []\n\tconst admin = { key: 'cn-admin', label: options.adminLabel || '', entries: [] }\n\tfor (const entry of Array.isArray(entries) ? entries : []) {\n\t\tconst declared = (entry && actionsById[entry.id]) || {}\n\t\tif (declared.adminOnly === true) {\n\t\t\tif (isAdmin) {\n\t\t\t\tadmin.entries.push(entry)\n\t\t\t}\n\t\t\tcontinue\n\t\t}\n\t\tconst label = typeof declared.group === 'string' ? declared.group.trim() : ''\n\t\tif (label === '') {\n\t\t\tplain.entries.push(entry)\n\t\t\tcontinue\n\t\t}\n\t\tlet group = named.find((candidate) => candidate.label === label)\n\t\tif (!group) {\n\t\t\tgroup = { key: `cn-group-${named.length}`, label, entries: [] }\n\t\t\tnamed.push(group)\n\t\t}\n\t\tgroup.entries.push(entry)\n\t}\n\treturn [plain, ...named, admin].filter((group) => group.entries.length > 0)\n}\n\n/**\n * Whether one checklist item is done for this record.\n *\n * `done` (a literal) wins, then `doneWhen` (a local visibleWhen condition),\n * then `doneField` (truthy, and for a list: not empty).\n *\n * @param {object} item The checklist item.\n * @param {object|null} object The record.\n * @return {boolean} True when the item is done.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-next-step-card\n */\nexport function isChecklistItemDone(item, object) {\n\tif (!item || typeof item !== 'object') {\n\t\treturn false\n\t}\n\tif (typeof item.done === 'boolean') {\n\t\treturn item.done\n\t}\n\tconst data = object && typeof object === 'object' ? object : {}\n\tif (item.doneWhen && typeof item.doneWhen === 'object') {\n\t\treturn evaluateVisibleWhenLocal(item.doneWhen, data)\n\t}\n\tif (typeof item.doneField === 'string' && item.doneField !== '') {\n\t\tconst value = readPath(data, item.doneField)\n\t\treturn Array.isArray(value) ? value.length > 0 : Boolean(value)\n\t}\n\treturn false\n}\n\n/**\n * Resolve the \"what now\" card for the record's stage.\n *\n * @param {{stages?: object, title?: string}|null} config The `nextStep` config.\n * @param {object|null} object The record.\n * @param {string} [stageField] Dot-path to the stage.\n * @return {{stage: string, title: string, items: Array<{label: string, done: boolean, hint: string}>, after: string}|null} The card, or null when this stage declares no checklist.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-next-step-card\n */\nexport function resolveNextStep(config, object, stageField = 'status') {\n\tif (!config || typeof config !== 'object') {\n\t\treturn null\n\t}\n\tconst stage = stageOf(object, config.field || stageField)\n\tconst declared = stageEntry(config.stages, stage)\n\tif (!declared || typeof declared !== 'object' || !Array.isArray(declared.checklist)) {\n\t\treturn null\n\t}\n\tconst items = declared.checklist\n\t\t.filter((item) => item && typeof item === 'object' && typeof item.label === 'string' && item.label !== '')\n\t\t.map((item) => ({\n\t\t\tlabel: item.label,\n\t\t\tdone: isChecklistItemDone(item, object),\n\t\t\thint: typeof item.hint === 'string' ? item.hint : '',\n\t\t}))\n\tif (items.length === 0) {\n\t\treturn null\n\t}\n\treturn {\n\t\tstage,\n\t\ttitle: typeof declared.title === 'string' ? declared.title : (typeof config.title === 'string' ? config.title : ''),\n\t\titems,\n\t\tafter: typeof declared.after === 'string' ? declared.after : '',\n\t}\n}\n\n/**\n * Resolve a header pill from the record.\n *\n * @param {{field?: string, colorMap?: object, labels?: object, variant?: string}|null} config The pill config.\n * @param {object|null} object The record.\n * @return {{label: string, colorKey: string, colorMap: object|null, variant: string}|null} What CnStatusBadge needs, or null when the field is empty.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-header-pills\n */\nexport function resolvePill(config, object) {\n\tif (!config || typeof config !== 'object' || typeof config.field !== 'string' || config.field === '') {\n\t\treturn null\n\t}\n\tconst raw = stageOf(object, config.field)\n\tif (raw === '') {\n\t\treturn null\n\t}\n\tconst mapped = stageEntry(config.labels, raw)\n\treturn {\n\t\tlabel: typeof mapped === 'string' && mapped !== '' ? mapped : raw,\n\t\tcolorKey: raw,\n\t\tcolorMap: config.colorMap && typeof config.colorMap === 'object' ? config.colorMap : null,\n\t\tvariant: typeof config.variant === 'string' && config.variant !== '' ? config.variant : 'default',\n\t}\n}\n\n/**\n * Resolve a tab's count.\n *\n * `count` (a number) wins. Otherwise `countField` is read off the record: a\n * list counts its items, a number is taken as is.\n *\n * @param {{count?: number, countField?: string}|null} tab The tab declaration.\n * @param {object|null} object The record.\n * @return {number|null} The count, or null when the tab declares none.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-tab-counts-and-overflow\n */\nexport function resolveTabCount(tab, object) {\n\tif (!tab || typeof tab !== 'object') {\n\t\treturn null\n\t}\n\tif (typeof tab.count === 'number' && Number.isFinite(tab.count)) {\n\t\treturn tab.count\n\t}\n\tif (typeof tab.countField !== 'string' || tab.countField === '') {\n\t\treturn null\n\t}\n\tconst value = readPath(object && typeof object === 'object' ? object : {}, tab.countField)\n\tif (Array.isArray(value)) {\n\t\treturn value.length\n\t}\n\tif (value === null || value === undefined || value === '') {\n\t\treturn 0\n\t}\n\tconst number = Number(value)\n\treturn Number.isFinite(number) ? number : null\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/dueRule.js

@@ -0,0 +1,84 @@
+import { daysUntil, resolveDateVariant } from './dateVariant.js';
+import { readPath } from './readPath.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * dueRule: decides whether a dated card is overdue, due soon or fine.
+ *
+ * A board's rule is `{ field, soonDays?, variantWhen? }`. `field` is a
+ * dot-path to the date on the row. `soonDays` (default 3) is how many days
+ * ahead still counts as "soon"; a date before today is overdue.
+ *
+ * The deciding is done by `utils/dateVariant.js`, the same rules a table's
+ * date cell uses, so a list and its board agree on what late means.
+ * `{ soonDays: 3 }` is shorthand for
+ * `variantWhen: [{ op: 'lt', value: 0, variant: 'error' }, { op: 'lte', value: 3, variant: 'warning' }]`,
+ * and a rule that carries its own `variantWhen` is used as written:
+ * `error` reads as overdue, `warning` as due soon.
+ *
+ * @module utils/dueRule
+ */
+
+
+/** How many days ahead counts as "soon" when the rule does not say. */
+const DEFAULT_SOON_DAYS = 3;
+
+/**
+ * The `variantWhen` rules a due rule stands for.
+ *
+ * @param {{soonDays?: number, variantWhen?: Array<object>}|null} [rule] The due rule.
+ * @return {Array<{op: string, value: number, variant: string}>} The rules `resolveDateVariant` takes.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards
+ */
+function dueRuleToVariantWhen(rule = {}) {
+	if (Array.isArray(rule?.variantWhen) && rule.variantWhen.length > 0) {
+		return rule.variantWhen
+	}
+	const given = rule?.soonDays;
+	const soonDays = given !== null && given !== undefined && Number.isFinite(Number(given)) ? Number(given) : DEFAULT_SOON_DAYS;
+	return [
+		{ op: 'lt', value: 0, variant: 'error' },
+		{ op: 'lte', value: soonDays, variant: 'warning' },
+	]
+}
+
+/**
+ * The due state of one date under a rule.
+ *
+ * @param {unknown} value The date.
+ * @param {{soonDays?: number, variantWhen?: Array<object>}|null} [rule] The rule.
+ * @param {Date} [now] The moment to measure from.
+ * @return {'overdue'|'soon'|'ok'|null} The state, or null when there is no readable date.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards
+ */
+function dueStateOf(value, rule = {}, now = new Date()) {
+	if (daysUntil(value, now) === null) {
+		return null
+	}
+	const variant = resolveDateVariant(value, dueRuleToVariantWhen(rule), now);
+	if (variant === 'error') {
+		return 'overdue'
+	}
+	return variant === 'warning' ? 'soon' : 'ok'
+}
+
+/**
+ * The due state of a row under a `{ field, soonDays }` rule.
+ *
+ * @param {object} row The row or card.
+ * @param {{field?: string, soonDays?: number, variantWhen?: Array<object>}|null} rule The rule. Null or field-less means no marking.
+ * @param {Date} [now] The moment to measure from.
+ * @return {'overdue'|'soon'|'ok'|null} The state, or null when the rule does not apply.
+ * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards
+ */
+function dueStateForRow(row, rule, now = new Date()) {
+	if (!rule || typeof rule.field !== 'string' || rule.field === '' || !row) {
+		return null
+	}
+	return dueStateOf(readPath(row, rule.field), rule, now)
+}
+
+export { DEFAULT_SOON_DAYS, daysUntil, dueRuleToVariantWhen, dueStateForRow, dueStateOf };
+//# sourceMappingURL=dueRule.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"dueRule.js","sources":["../../../src/utils/dueRule.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * dueRule: decides whether a dated card is overdue, due soon or fine.\n *\n * A board's rule is `{ field, soonDays?, variantWhen? }`. `field` is a\n * dot-path to the date on the row. `soonDays` (default 3) is how many days\n * ahead still counts as \"soon\"; a date before today is overdue.\n *\n * The deciding is done by `utils/dateVariant.js`, the same rules a table's\n * date cell uses, so a list and its board agree on what late means.\n * `{ soonDays: 3 }` is shorthand for\n * `variantWhen: [{ op: 'lt', value: 0, variant: 'error' }, { op: 'lte', value: 3, variant: 'warning' }]`,\n * and a rule that carries its own `variantWhen` is used as written:\n * `error` reads as overdue, `warning` as due soon.\n *\n * @module utils/dueRule\n */\n\nimport { daysUntil, parseDateValue, resolveDateVariant } from './dateVariant.js'\nimport { readPath } from './readPath.js'\n\nexport { daysUntil }\n\n/** How many days ahead counts as \"soon\" when the rule does not say. */\nexport const DEFAULT_SOON_DAYS = 3\n\n/**\n * Local midnight of a date value. A bare `YYYY-MM-DD` is a LOCAL day.\n *\n * @param {unknown} value A Date, a timestamp or a date string.\n * @return {Date|null} Local midnight of that day, or null when unreadable.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards\n */\nexport function toLocalDay(value) {\n\tconst date = parseDateValue(value)\n\treturn date === null ? null : new Date(date.getFullYear(), date.getMonth(), date.getDate())\n}\n\n/**\n * The `variantWhen` rules a due rule stands for.\n *\n * @param {{soonDays?: number, variantWhen?: Array<object>}|null} [rule] The due rule.\n * @return {Array<{op: string, value: number, variant: string}>} The rules `resolveDateVariant` takes.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards\n */\nexport function dueRuleToVariantWhen(rule = {}) {\n\tif (Array.isArray(rule?.variantWhen) && rule.variantWhen.length > 0) {\n\t\treturn rule.variantWhen\n\t}\n\tconst given = rule?.soonDays\n\tconst soonDays = given !== null && given !== undefined && Number.isFinite(Number(given)) ? Number(given) : DEFAULT_SOON_DAYS\n\treturn [\n\t\t{ op: 'lt', value: 0, variant: 'error' },\n\t\t{ op: 'lte', value: soonDays, variant: 'warning' },\n\t]\n}\n\n/**\n * The due state of one date under a rule.\n *\n * @param {unknown} value The date.\n * @param {{soonDays?: number, variantWhen?: Array<object>}|null} [rule] The rule.\n * @param {Date} [now] The moment to measure from.\n * @return {'overdue'|'soon'|'ok'|null} The state, or null when there is no readable date.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards\n */\nexport function dueStateOf(value, rule = {}, now = new Date()) {\n\tif (daysUntil(value, now) === null) {\n\t\treturn null\n\t}\n\tconst variant = resolveDateVariant(value, dueRuleToVariantWhen(rule), now)\n\tif (variant === 'error') {\n\t\treturn 'overdue'\n\t}\n\treturn variant === 'warning' ? 'soon' : 'ok'\n}\n\n/**\n * The due state of a row under a `{ field, soonDays }` rule.\n *\n * @param {object} row The row or card.\n * @param {{field?: string, soonDays?: number, variantWhen?: Array<object>}|null} rule The rule. Null or field-less means no marking.\n * @param {Date} [now] The moment to measure from.\n * @return {'overdue'|'soon'|'ok'|null} The state, or null when the rule does not apply.\n * @spec openspec/changes/detail-action-model-and-case-surfaces/specs/detail-action-model/spec.md#requirement-late-marking-on-board-cards\n */\nexport function dueStateForRow(row, rule, now = new Date()) {\n\tif (!rule || typeof rule.field !== 'string' || rule.field === '' || !row) {\n\t\treturn null\n\t}\n\treturn dueStateOf(readPath(row, rule.field), rule, now)\n}\n"],"names":[],"mappings":";;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAKA;AACA;AACY,MAAC,iBAAiB,GAAG,EAAC;AAalC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,oBAAoB,CAAC,IAAI,GAAG,EAAE,EAAE;AAChD,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE;AACtE,EAAE,OAAO,IAAI,CAAC,WAAW;AACzB,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,IAAI,EAAE,SAAQ;AAC7B,CAAC,MAAM,QAAQ,GAAG,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,kBAAiB;AAC7H,CAAC,OAAO;AACR,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE;AAC1C,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,SAAS,EAAE;AACpD,EAAE;AACF,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE;AAC/D,CAAC,IAAI,SAAS,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;AACrC,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,MAAM,OAAO,GAAG,kBAAkB,CAAC,KAAK,EAAE,oBAAoB,CAAC,IAAI,CAAC,EAAE,GAAG,EAAC;AAC3E,CAAC,IAAI,OAAO,KAAK,OAAO,EAAE;AAC1B,EAAE,OAAO,SAAS;AAClB,EAAE;AACF,CAAC,OAAO,OAAO,KAAK,SAAS,GAAG,MAAM,GAAG,IAAI;AAC7C,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,GAAG,EAAE,IAAI,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE;AAC5D,CAAC,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE;AAC3E,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,OAAO,UAAU,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC;AACxD;;;;"}

package/dist/esm/utils/fetchAggregate.js

@@ -79,5 +79,41 @@ async function fetchAggregateValue(source, ctx) {
 	return (res && res.data && res.data.value !== undefined) ? res.data.value : null
 }
 
-export { fetchAggregateValue, flattenAggFilter };
+/**
+ * Fetch the object count per distinct value of one field, in ONE request,
+ * from OpenRegister's `/grouped` aggregation endpoint.
+ *
+ * @param {object} source The grouped descriptor.
+ * @param {string} source.register The register slug.
+ * @param {string} source.schema The schema slug.
+ * @param {string} source.groupBy The field to group on.
+ * @param {object} [source.filter] The filter map.
+ * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional
+ *   token-resolution context for the filter.
+ * @return {Promise<Array<{key: string, count: number}>>} One entry per group; [] when the source is incomplete.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-stacked-bar-widget
+ */
+async function fetchGroupedCounts(source, ctx) {
+	const s = source || {};
+	if (!s.register || !s.schema || !s.groupBy) {
+		return []
+	}
+	const [{ default: axios }, { generateUrl }] = await Promise.all([
+		import('@nextcloud/axios'),
+		import('@nextcloud/router'),
+	]);
+	const url = generateUrl(
+		'/apps/openregister/api/objects/aggregations/{register}/{schema}/grouped',
+		{ register: s.register, schema: s.schema },
+	);
+	const params = { groupBy: s.groupBy, metric: 'count' };
+	flattenAggFilter(params, s.filter || {}, ctx);
+	const res = await axios.get(url, { params });
+	const groups = (res && res.data && Array.isArray(res.data.groups)) ? res.data.groups : [];
+	return groups
+		.filter((g) => g && g.key !== null && g.key !== undefined && g.key !== '')
+		.map((g) => ({ key: String(g.key), count: Number(g.value) || 0 }))
+}
+
+export { fetchAggregateValue, fetchGroupedCounts, flattenAggFilter };
 //# sourceMappingURL=fetchAggregate.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"fetchAggregate.js","sources":["../../../src/utils/fetchAggregate.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Shared helper for the abstract data widgets (CnStatWidget, CnDeltaWidget,\n * CnGaugeWidget, …) — fetches ONE scalar from OpenRegister's ad-hoc aggregation\n * `/value` endpoint given a `{ register, schema, metric, field, filter }`\n * descriptor. Filter values run through `resolveFilterTokens` first, so relative\n * tokens (`@me`, `@monthStart`, `@currentFiscalYear`, …) resolve at fetch time.\n *\n * @module utils/fetchAggregate\n */\n\nimport { resolveFilterTokens } from './resolveFilterTokens.js'\n\n/**\n * Flatten a filter map into operator-aware `filter[key]` / `filter[key][op]`\n * query params (the OpenRegister aggregation filter vocabulary). Resolves\n * relative tokens before writing.\n *\n * @param {object} target The params object to write into.\n * @param {object} filter The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context forwarded to {@link resolveFilterTokens} so a\n *   detail-page aggregate can scope its filter to the current object via\n *   `@objectId` / `@object.<field>`.\n * @return {void}\n */\nexport function flattenAggFilter(target, filter, ctx) {\n\tif (!filter || typeof filter !== 'object') {\n\t\treturn\n\t}\n\tfilter = resolveFilterTokens(filter, ctx)\n\tfor (const [k, v] of Object.entries(filter)) {\n\t\tif (v && typeof v === 'object') {\n\t\t\tfor (const [op, ov] of Object.entries(v)) {\n\t\t\t\ttarget[`filter[${k}][${op}]`] = ov\n\t\t\t}\n\t\t} else if (v !== '' && v !== null && v !== undefined) {\n\t\t\ttarget[`filter[${k}]`] = v\n\t\t}\n\t}\n}\n\n/**\n * Fetch one aggregated scalar from OpenRegister.\n *\n * @param {object} source The aggregate descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} [source.metric] count | sum | avg | min | max (default count).\n * @param {string} [source.field] The numeric field (required for non-count metrics).\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context (a detail page's object context) so the filter can\n *   scope to the current object via `@objectId` / `@object.<field>`.\n * @return {Promise<number|null>} The aggregated value, or null when unavailable.\n */\nexport async function fetchAggregateValue(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema) {\n\t\treturn null\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/value',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { metric: s.metric || 'count' }\n\tif (s.field) {\n\t\tparams.field = s.field\n\t}\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\treturn (res && res.data && res.data.value !== undefined) ? res.data.value : null\n}\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE;AACtD,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC5C,EAAE,MAAM;AACR,EAAE;AACF,CAAC,MAAM,GAAG,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAC;AAC1C,CAAC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;AAC9C,EAAE,IAAI,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE;AAClC,GAAG,KAAK,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;AAC7C,IAAI,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAE;AACtC,IAAI;AACJ,GAAG,MAAM,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,KAAK,SAAS,EAAE;AACxD,GAAG,MAAM,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAC;AAC7B,GAAG;AACH,EAAE;AACF,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,mBAAmB,CAAC,MAAM,EAAE,GAAG,EAAE;AACvD,CAAC,MAAM,CAAC,GAAG,MAAM,IAAI,GAAE;AACvB,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE;AAC/B,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,WAAW,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;AACjE,EAAE,OAAO,kBAAkB,CAAC;AAC5B,EAAE,OAAO,mBAAmB,CAAC;AAC7B,EAAE,EAAC;AACH,CAAC,MAAM,GAAG,GAAG,WAAW;AACxB,EAAE,uEAAuE;AACzE,EAAE,EAAE,QAAQ,EAAE,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;AAC5C,GAAE;AACF,CAAC,MAAM,MAAM,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,OAAO,GAAE;AAC/C,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE;AACd,EAAE,MAAM,CAAC,KAAK,GAAG,CAAC,CAAC,MAAK;AACxB,EAAE;AACF,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,GAAG,EAAC;AAC9C,CAAC,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAC;AAC7C,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI;AACjF;;;;"}
+{"version":3,"file":"fetchAggregate.js","sources":["../../../src/utils/fetchAggregate.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Shared helper for the abstract data widgets (CnStatWidget, CnDeltaWidget,\n * CnGaugeWidget, …) — fetches ONE scalar from OpenRegister's ad-hoc aggregation\n * `/value` endpoint given a `{ register, schema, metric, field, filter }`\n * descriptor. Filter values run through `resolveFilterTokens` first, so relative\n * tokens (`@me`, `@monthStart`, `@currentFiscalYear`, …) resolve at fetch time.\n *\n * @module utils/fetchAggregate\n */\n\nimport { resolveFilterTokens } from './resolveFilterTokens.js'\n\n/**\n * Flatten a filter map into operator-aware `filter[key]` / `filter[key][op]`\n * query params (the OpenRegister aggregation filter vocabulary). Resolves\n * relative tokens before writing.\n *\n * @param {object} target The params object to write into.\n * @param {object} filter The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context forwarded to {@link resolveFilterTokens} so a\n *   detail-page aggregate can scope its filter to the current object via\n *   `@objectId` / `@object.<field>`.\n * @return {void}\n */\nexport function flattenAggFilter(target, filter, ctx) {\n\tif (!filter || typeof filter !== 'object') {\n\t\treturn\n\t}\n\tfilter = resolveFilterTokens(filter, ctx)\n\tfor (const [k, v] of Object.entries(filter)) {\n\t\tif (v && typeof v === 'object') {\n\t\t\tfor (const [op, ov] of Object.entries(v)) {\n\t\t\t\ttarget[`filter[${k}][${op}]`] = ov\n\t\t\t}\n\t\t} else if (v !== '' && v !== null && v !== undefined) {\n\t\t\ttarget[`filter[${k}]`] = v\n\t\t}\n\t}\n}\n\n/**\n * Fetch one aggregated scalar from OpenRegister.\n *\n * @param {object} source The aggregate descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} [source.metric] count | sum | avg | min | max (default count).\n * @param {string} [source.field] The numeric field (required for non-count metrics).\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context (a detail page's object context) so the filter can\n *   scope to the current object via `@objectId` / `@object.<field>`.\n * @return {Promise<number|null>} The aggregated value, or null when unavailable.\n */\nexport async function fetchAggregateValue(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema) {\n\t\treturn null\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/value',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { metric: s.metric || 'count' }\n\tif (s.field) {\n\t\tparams.field = s.field\n\t}\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\treturn (res && res.data && res.data.value !== undefined) ? res.data.value : null\n}\n\n/**\n * Fetch the object count per distinct value of one field, in ONE request,\n * from OpenRegister's `/grouped` aggregation endpoint.\n *\n * @param {object} source The grouped descriptor.\n * @param {string} source.register The register slug.\n * @param {string} source.schema The schema slug.\n * @param {string} source.groupBy The field to group on.\n * @param {object} [source.filter] The filter map.\n * @param {{objectId?: (string|number), object?: object, workspace?: object}} [ctx] Optional\n *   token-resolution context for the filter.\n * @return {Promise<Array<{key: string, count: number}>>} One entry per group; [] when the source is incomplete.\n * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-stacked-bar-widget\n */\nexport async function fetchGroupedCounts(source, ctx) {\n\tconst s = source || {}\n\tif (!s.register || !s.schema || !s.groupBy) {\n\t\treturn []\n\t}\n\tconst [{ default: axios }, { generateUrl }] = await Promise.all([\n\t\timport('@nextcloud/axios'),\n\t\timport('@nextcloud/router'),\n\t])\n\tconst url = generateUrl(\n\t\t'/apps/openregister/api/objects/aggregations/{register}/{schema}/grouped',\n\t\t{ register: s.register, schema: s.schema },\n\t)\n\tconst params = { groupBy: s.groupBy, metric: 'count' }\n\tflattenAggFilter(params, s.filter || {}, ctx)\n\tconst res = await axios.get(url, { params })\n\tconst groups = (res && res.data && Array.isArray(res.data.groups)) ? res.data.groups : []\n\treturn groups\n\t\t.filter((g) => g && g.key !== null && g.key !== undefined && g.key !== '')\n\t\t.map((g) => ({ key: String(g.key), count: Number(g.value) || 0 }))\n}\n"],"names":[],"mappings":"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"}