@conduction/nextcloud-vue 2.58.0 → 2.60.0

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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"}

package/dist/esm/utils/fetchFilterCounts.js

@@ -0,0 +1,186 @@
+import { fetchGroupedCounts, fetchAggregateValue } from './fetchAggregate.js';
+import { buildQueryString, prefixUrl, buildHeaders } from './headers.js';
+import { resolveFilterTokens } from './resolveFilterTokens.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * fetchFilterCounts: how many records each of a set of filters matches, in as
+ * few requests as the API allows.
+ *
+ * Quick filters and saved views usually differ in ONE field (`status: open`,
+ * `status: closed`, ...). Those are answered by one `/grouped` request on that
+ * field. A filter that narrows on something else (two fields, an operator, a
+ * list of values) cannot be read off a grouped result, so each of those costs
+ * one `/value` count. A filter that holds a LIST of values is counted through
+ * the list endpoint, because the aggregation endpoints cannot express it.
+ * Nothing is requested for an entry that did not ask.
+ *
+ * @module utils/fetchFilterCounts
+ */
+
+
+/**
+ * Whether a filter holds a list of values (`{ status: ['open', 'hold'] }`).
+ *
+ * The aggregation endpoints have no spelling for "one of these values", so a
+ * filter like this is never sent to them. It is counted through the list
+ * endpoint instead, which is where the page's own request sends it.
+ *
+ * @param {object} filter A filter map.
+ * @return {boolean} True when any value is an array.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+ */
+function hasListValue(filter) {
+	if (!filter || typeof filter !== 'object') {
+		return false
+	}
+	return Object.values(filter).some((value) => Array.isArray(value))
+}
+
+/**
+ * Count the records a filter matches by asking the LIST endpoint for one
+ * record and reading its `total`. The filter is sent the way the list request
+ * sends it: a list of values as repeated `field[]=`, an operator as
+ * `field[op]=`.
+ *
+ * @param {string} register The register slug.
+ * @param {string} schema The schema slug.
+ * @param {object} filter The filter map.
+ * @param {object} [ctx] Token-resolution context for the filter.
+ * @return {Promise<number|null>} The total, or null when the response carries none.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+ */
+async function fetchListTotal(register, schema, filter, ctx) {
+	const resolved = resolveFilterTokens(filter || {}, ctx || {});
+	const params = {};
+	for (const [key, value] of Object.entries(resolved || {})) {
+		if (value && typeof value === 'object' && !Array.isArray(value)) {
+			for (const [op, operand] of Object.entries(value)) {
+				params[`${key}[${op}]`] = operand;
+			}
+		} else {
+			params[key] = value;
+		}
+	}
+	const qs = buildQueryString({ ...params, _limit: 1 });
+	const url = prefixUrl(`/apps/openregister/api/objects/${encodeURIComponent(register)}/${encodeURIComponent(schema)}${qs}`);
+	const response = await fetch(url, { headers: buildHeaders() });
+	if (!response.ok) {
+		throw new Error(`list returned ${response.status}`)
+	}
+	const data = await response.json();
+	return typeof data.total === 'number' ? data.total : null
+}
+
+/**
+ * The single field a filter narrows on with a plain equality, or null when the
+ * filter is anything else.
+ *
+ * @param {object} filter A filter map.
+ * @return {{field: string, value: string}|null} The field and the value it must equal.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+ */
+function singleEqualityOf(filter) {
+	if (!filter || typeof filter !== 'object' || Array.isArray(filter)) {
+		return null
+	}
+	const keys = Object.keys(filter);
+	if (keys.length !== 1) {
+		return null
+	}
+	const value = filter[keys[0]];
+	if (value === null || value === undefined || value === '' || typeof value === 'object') {
+		return null
+	}
+	// A token (`@me`, `@today`) resolves to a value the grouped keys are
+	// compared against only after resolution, which the count request does.
+	if (typeof value === 'string' && value.charAt(0) === '@') {
+		return null
+	}
+	return { field: keys[0], value: String(value) }
+}
+
+/**
+ * Count the records each entry's filter matches.
+ *
+ * @param {object} options The request.
+ * @param {string} options.register The register slug.
+ * @param {string} options.schema The schema slug.
+ * @param {Array<{key: (string|number), filter: object}>} options.entries The filters to count, each under its own key.
+ * @param {object} [options.baseFilter] A filter every count is narrowed by (the page's fixed filter).
+ * @param {object} [options.ctx] Token-resolution context for the filters.
+ * @return {Promise<{[key: string]: number}>} The count per entry key. An entry whose count failed is left out.
+ * @spec openspec/changes/workplace-dashboard-primitives/specs/workplace-dashboard-primitives/spec.md#requirement-counts-on-filters-and-views
+ */
+async function fetchFilterCounts({ register, schema, entries, baseFilter, ctx } = {}) {
+	const counts = {};
+	if (!register || !schema || !Array.isArray(entries) || entries.length === 0) {
+		return counts
+	}
+	const base = (baseFilter && typeof baseFilter === 'object') ? baseFilter : {};
+
+	// Entries that share one equality field go into one grouped request, but
+	// only when at least two do: a lone entry costs one request either way,
+	// and `/value` returns exactly its number.
+	// A list of values anywhere in a request rules the aggregation endpoints
+	// out for it. A base filter with one rules them out for every entry.
+	const baseHasList = hasListValue(base);
+	const byField = {};
+	const single = [];
+	const viaList = [];
+	for (const entry of entries) {
+		if (baseHasList || hasListValue(entry.filter)) {
+			viaList.push(entry);
+			continue
+		}
+		const eq = singleEqualityOf(entry.filter);
+		if (eq !== null && !(eq.field in base)) {
+			(byField[eq.field] = byField[eq.field] || []).push({ entry, value: eq.value });
+		} else {
+			single.push(entry);
+		}
+	}
+	const jobs = [];
+	for (const [field, members] of Object.entries(byField)) {
+		if (members.length < 2) {
+			single.push(members[0].entry);
+			continue
+		}
+		jobs.push(fetchGroupedCounts({ register, schema, groupBy: field, filter: base }, ctx)
+			.then((groups) => {
+				const map = {};
+				for (const group of groups) {
+					map[group.key] = group.count;
+				}
+				for (const member of members) {
+					counts[member.entry.key] = map[member.value] || 0;
+				}
+			})
+			.catch(() => {}));
+	}
+	for (const entry of single) {
+		jobs.push(fetchAggregateValue({ register, schema, metric: 'count', filter: { ...base, ...(entry.filter || {}) } }, ctx)
+			.then((value) => {
+				if (value !== null && Number.isFinite(Number(value))) {
+					counts[entry.key] = Number(value);
+				}
+			})
+			.catch(() => {}));
+	}
+	for (const entry of viaList) {
+		jobs.push(fetchListTotal(register, schema, { ...base, ...(entry.filter || {}) }, ctx)
+			.then((total) => {
+				if (total !== null) {
+					counts[entry.key] = total;
+				}
+			})
+			.catch(() => {}));
+	}
+	await Promise.all(jobs);
+	return counts
+}
+
+export { fetchFilterCounts, fetchListTotal, hasListValue, singleEqualityOf };
+//# sourceMappingURL=fetchFilterCounts.js.map