@conduction/nextcloud-vue 2.79.0 → 2.81.0

package/dist/esm/utils/fillTemplate.js

@@ -0,0 +1,120 @@
+import { formatBoardDate, boardDateLocale } from './boardDate.js';
+import { parseDateValue } from './dateVariant.js';
+import { readPath } from './readPath.js';
+
+// SPDX-FileCopyrightText: 2026 Conduction B.V.
+// SPDX-License-Identifier: EUPL-1.2
+
+
+const TOKEN = /\{([^{}\s|]+)(?:\|([a-z]+))?\}/g;
+
+/**
+ * A moment in the board's short form with the time: "4 okt, 10:52", or
+ * "14 feb 2024, 09:00" outside the current year.
+ *
+ * @param {unknown} value A Date, a timestamp or an ISO string.
+ * @param {Date} [now] The reference moment.
+ * @return {string} The text, or '' when the value is not a date.
+ * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record
+ */
+function formatBoardDateTime(value, now = new Date()) {
+	const day = formatBoardDate(value, now);
+	const date = parseDateValue(value);
+	if (day === '' || date === null) {
+		return ''
+	}
+	let time;
+	try {
+		time = new Intl.DateTimeFormat(boardDateLocale(), { hour: '2-digit', minute: '2-digit' }).format(date);
+	} catch {
+		time = new Intl.DateTimeFormat(undefined, { hour: '2-digit', minute: '2-digit' }).format(date);
+	}
+	return `${day}, ${time}`
+}
+
+/**
+ * Format one token value.
+ *
+ * @param {unknown} value The raw value.
+ * @param {string} format `date`, `datetime` or '' (as is).
+ * @param {Date} now The reference moment.
+ * @return {string} The text, '' when nothing can be shown.
+ */
+function formatValue(value, format, now) {
+	if (value === null || value === undefined || value === '' || typeof value === 'object') {
+		return ''
+	}
+	if (format === 'date') {
+		return formatBoardDate(value, now)
+	}
+	if (format === 'datetime') {
+		return formatBoardDateTime(value, now)
+	}
+	if (format === 'days') {
+		// Whole days from the date to now (0 for today; negative for a future date).
+		const date = parseDateValue(value);
+		return date === null ? '' : String(Math.floor((now.getTime() - date.getTime()) / 86400000))
+	}
+	return String(value)
+}
+
+/**
+ * Fill a row template such as `"{identifier} · {caseTypeName}"` or
+ * `"Termijn {deadline|date}"` from an object.
+ *
+ * Every `{path}` token is a dot path into the object; `{path|date}` and
+ * `{path|datetime}` format it as the boards write dates, and `{path|days}` is the
+ * whole days since that date ("has waited {createdAt|days} days"). A token without a
+ * value empties the WHOLE template, because "Termijn " is worse than nothing.
+ * A template without tokens is returned as written (a constant label).
+ *
+ * @param {string} template The template, already translated.
+ * @param {object|null} object The object to read.
+ * @param {Date} [now] The reference moment for dates.
+ * @return {string} The filled text, or ''.
+ * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record
+ */
+function fillTemplate(template, object, now = new Date()) {
+	if (typeof template !== 'string' || template.trim() === '') {
+		return ''
+	}
+	let missing = false;
+	const text = template.replace(TOKEN, (_match, path, format) => {
+		const value = object && typeof object === 'object' ? readPath(object, path) : undefined;
+		const shown = formatValue(value, format || '', now);
+		if (shown === '') {
+			missing = true;
+		}
+		return shown
+	});
+	return missing ? '' : text.trim()
+}
+
+/**
+ * The first of several templates that fills: `["Klaar {closedAt|date}",
+ * "Termijn {deadline|date}"]` reads "Klaar ..." once the case is closed and
+ * "Termijn ..." while it is open. A single string is one candidate.
+ *
+ * @param {string|string[]} templates The candidates, in order.
+ * @param {object|null} object The object to read.
+ * @param {(key: string) => string} [translate] Applied to each template before filling.
+ * @param {Date} [now] The reference moment for dates.
+ * @return {string} The first filled text, or ''.
+ * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record
+ */
+function firstFilled(templates, object, translate = (key) => key, now = new Date()) {
+	const list = Array.isArray(templates) ? templates : [templates];
+	for (const template of list) {
+		if (typeof template !== 'string') {
+			continue
+		}
+		const text = fillTemplate(translate(template), object, now);
+		if (text !== '') {
+			return text
+		}
+	}
+	return ''
+}
+
+export { fillTemplate, firstFilled, formatBoardDateTime };
+//# sourceMappingURL=fillTemplate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fillTemplate.js","sources":["../../../src/utils/fillTemplate.js"],"sourcesContent":["// SPDX-FileCopyrightText: 2026 Conduction B.V.\n// SPDX-License-Identifier: EUPL-1.2\n\nimport { boardDateLocale, formatBoardDate } from './boardDate.js'\nimport { parseDateValue } from './dateVariant.js'\nimport { readPath } from './readPath.js'\n\nconst TOKEN = /\\{([^{}\\s|]+)(?:\\|([a-z]+))?\\}/g\n\n/**\n * A moment in the board's short form with the time: \"4 okt, 10:52\", or\n * \"14 feb 2024, 09:00\" outside the current year.\n *\n * @param {unknown} value A Date, a timestamp or an ISO string.\n * @param {Date} [now] The reference moment.\n * @return {string} The text, or '' when the value is not a date.\n * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record\n */\nexport function formatBoardDateTime(value, now = new Date()) {\n\tconst day = formatBoardDate(value, now)\n\tconst date = parseDateValue(value)\n\tif (day === '' || date === null) {\n\t\treturn ''\n\t}\n\tlet time\n\ttry {\n\t\ttime = new Intl.DateTimeFormat(boardDateLocale(), { hour: '2-digit', minute: '2-digit' }).format(date)\n\t} catch {\n\t\ttime = new Intl.DateTimeFormat(undefined, { hour: '2-digit', minute: '2-digit' }).format(date)\n\t}\n\treturn `${day}, ${time}`\n}\n\n/**\n * Format one token value.\n *\n * @param {unknown} value The raw value.\n * @param {string} format `date`, `datetime` or '' (as is).\n * @param {Date} now The reference moment.\n * @return {string} The text, '' when nothing can be shown.\n */\nfunction formatValue(value, format, now) {\n\tif (value === null || value === undefined || value === '' || typeof value === 'object') {\n\t\treturn ''\n\t}\n\tif (format === 'date') {\n\t\treturn formatBoardDate(value, now)\n\t}\n\tif (format === 'datetime') {\n\t\treturn formatBoardDateTime(value, now)\n\t}\n\tif (format === 'days') {\n\t\t// Whole days from the date to now (0 for today; negative for a future date).\n\t\tconst date = parseDateValue(value)\n\t\treturn date === null ? '' : String(Math.floor((now.getTime() - date.getTime()) / 86400000))\n\t}\n\treturn String(value)\n}\n\n/**\n * Fill a row template such as `\"{identifier} · {caseTypeName}\"` or\n * `\"Termijn {deadline|date}\"` from an object.\n *\n * Every `{path}` token is a dot path into the object; `{path|date}` and\n * `{path|datetime}` format it as the boards write dates, and `{path|days}` is the\n * whole days since that date (\"has waited {createdAt|days} days\"). A token without a\n * value empties the WHOLE template, because \"Termijn \" is worse than nothing.\n * A template without tokens is returned as written (a constant label).\n *\n * @param {string} template The template, already translated.\n * @param {object|null} object The object to read.\n * @param {Date} [now] The reference moment for dates.\n * @return {string} The filled text, or ''.\n * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record\n */\nexport function fillTemplate(template, object, now = new Date()) {\n\tif (typeof template !== 'string' || template.trim() === '') {\n\t\treturn ''\n\t}\n\tlet missing = false\n\tconst text = template.replace(TOKEN, (_match, path, format) => {\n\t\tconst value = object && typeof object === 'object' ? readPath(object, path) : undefined\n\t\tconst shown = formatValue(value, format || '', now)\n\t\tif (shown === '') {\n\t\t\tmissing = true\n\t\t}\n\t\treturn shown\n\t})\n\treturn missing ? '' : text.trim()\n}\n\n/**\n * The first of several templates that fills: `[\"Klaar {closedAt|date}\",\n * \"Termijn {deadline|date}\"]` reads \"Klaar ...\" once the case is closed and\n * \"Termijn ...\" while it is open. A single string is one candidate.\n *\n * @param {string|string[]} templates The candidates, in order.\n * @param {object|null} object The object to read.\n * @param {(key: string) => string} [translate] Applied to each template before filling.\n * @param {Date} [now] The reference moment for dates.\n * @return {string} The first filled text, or ''.\n * @spec openspec/changes/screens-relation-pages/specs/relation-pages/spec.md#requirement-a-record-list-shows-the-objects-that-point-at-this-record\n */\nexport function firstFilled(templates, object, translate = (key) => key, now = new Date()) {\n\tconst list = Array.isArray(templates) ? templates : [templates]\n\tfor (const template of list) {\n\t\tif (typeof template !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst text = fillTemplate(translate(template), object, now)\n\t\tif (text !== '') {\n\t\t\treturn text\n\t\t}\n\t}\n\treturn ''\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/initials.js

@@ -0,0 +1,32 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * initials: the letters an avatar shows for a free name.
+ *
+ * @module utils/initials
+ */
+
+/**
+ * The initials of a name: the first letters of its first and its last word,
+ * upper-cased ("Sanne de Vries" reads "SV", "Jan" reads "J").
+ *
+ * @param {unknown} name The name.
+ * @return {string} One or two letters, or '' when there is no name.
+ * @spec openspec/changes/screens-record-list-avatar/specs/record-list-avatar/spec.md#requirement-a-record-list-row-can-carry-an-avatar
+ */
+function initialsOf(name) {
+	if (typeof name !== 'string') {
+		return ''
+	}
+	const words = name.trim().split(/\s+/).filter((word) => word !== '');
+	if (words.length === 0) {
+		return ''
+	}
+	const first = Array.from(words[0])[0] || '';
+	const last = words.length > 1 ? (Array.from(words[words.length - 1])[0] || '') : '';
+	return (first + last).toLocaleUpperCase()
+}
+
+export { initialsOf };
+//# sourceMappingURL=initials.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"initials.js","sources":["../../../src/utils/initials.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * initials: the letters an avatar shows for a free name.\n *\n * @module utils/initials\n */\n\n/**\n * The initials of a name: the first letters of its first and its last word,\n * upper-cased (\"Sanne de Vries\" reads \"SV\", \"Jan\" reads \"J\").\n *\n * @param {unknown} name The name.\n * @return {string} One or two letters, or '' when there is no name.\n * @spec openspec/changes/screens-record-list-avatar/specs/record-list-avatar/spec.md#requirement-a-record-list-row-can-carry-an-avatar\n */\nexport function initialsOf(name) {\n\tif (typeof name !== 'string') {\n\t\treturn ''\n\t}\n\tconst words = name.trim().split(/\\s+/).filter((word) => word !== '')\n\tif (words.length === 0) {\n\t\treturn ''\n\t}\n\tconst first = Array.from(words[0])[0] || ''\n\tconst last = words.length > 1 ? (Array.from(words[words.length - 1])[0] || '') : ''\n\treturn (first + last).toLocaleUpperCase()\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,UAAU,CAAC,IAAI,EAAE;AACjC,CAAC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE;AAC/B,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,KAAK,EAAE,EAAC;AACrE,CAAC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE;AACzB,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,GAAE;AAC5C,CAAC,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,GAAE;AACpF,CAAC,OAAO,CAAC,KAAK,GAAG,IAAI,EAAE,iBAAiB,EAAE;AAC1C;;;;"}

package/dist/esm/utils/libraryWidgetKeys.js

@@ -94,6 +94,8 @@ const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'banner',
 	'calendar',
 	'chart',
+	'chips-field',
+	'choice-picker',
 	'container',
 	'conversation',
 	'countdown',
@@ -101,6 +103,8 @@ const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'delta',
 	'divider',
 	'document-review',
+	'facts',
+	'field-list',
 	'files',
 	'flow-runs',
 	'gauge',
@@ -124,19 +128,26 @@ const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'object-table',
 	'people',
 	'quicklinks',
+	'radio-cards',
+	'record-list',
 	'related',
 	'saved-view',
+	'saved-views',
+	'sections',
+	'settings-form',
 	'spend-analytics',
 	'stacked-bar',
 	'stages',
 	'stat',
 	'stats-block',
+	'switch-rows',
 	'table',
 	'tabs',
 	'tasks',
 	'text',
 	'tile',
 	'timeline',
+	'toggle-table',
 	'video',
 	'week-strip',
 	'workspace-filter',

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

@@ -1 +1 @@
-{"version":3,"file":"libraryWidgetKeys.js","sources":["../../../src/utils/libraryWidgetKeys.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * libraryWidgetKeys — the one vocabulary of widget keys the LIBRARY itself\n * renders, and the only list `validateManifestV2` is allowed to consult.\n *\n * WHY THIS MODULE EXISTS\n * ----------------------\n * The validator used to carry its own hand-written array of \"library built-in\n * widget keys\", with a comment instructing whoever added a built-in to append\n * it \"in the same PR\". That instruction was followed for five keys and missed\n * for six, so the validator knew 11 keys while the library actually rendered\n * 45. Nothing failed when the two disagreed, because the only consumer is an\n * exemption: a key the validator does not recognise is treated as a CUSTOM\n * registry component, which makes a legitimate single-widget library dashboard\n * fail the ADR-036 Decision 1 anti-pattern rule with advice (\"declare it as\n * type:'custom'\") that is wrong for a library widget.\n *\n * A comment cannot enforce anything, so the array moved here and\n * `tests/utils/libraryWidgetKeys.spec.js` now binds it to the two registries\n * that actually resolve a key at runtime:\n *\n *   1. `BUILT_IN_WIDGETS` (components/CnWidgetGrid/builtInWidgets.js) — the v2\n *      manifest widget set `CnWidgetGrid` resolves a `widgetKey` against.\n *   2. The dashboard widget catalog (`dashboardWidgetRegistry`), populated by\n *      `registerDashboardWidgets.js`. `CnWidgetGrid` falls back to it (third in\n *      the chain, after the consumer registry and `BUILT_IN_WIDGETS`), so a\n *      catalog key renders on a v2 page exactly like a `BUILT_IN_WIDGETS` one.\n *\n * The test asserts SET EQUALITY in both directions against the live registries,\n * so adding a widget to either registry without touching this file fails CI,\n * and deleting one without removing it here fails too. The lists below are the\n * validator's view; the registries are the truth the test holds them to.\n *\n * THE CATALOG IS NOT LEGACY. It is a live half of the same vocabulary, and the\n * old array already conceded the point by exempting `chart` and `stats-block`,\n * which are catalog-only keys that `BUILT_IN_WIDGETS` has never held. What it\n * got wrong was doing that for two keys and not the other thirty-seven.\n * `widgetDispatch.js` unified the two resolution paths for the same reason: a\n * widget authored against one vocabulary was invisible to the other and said\n * nothing about why (101 of 236 detail widgets on hrmq).\n *\n * @module utils/libraryWidgetKeys\n */\n\nimport { WIDGET_TYPE_ALIASES } from './widgetTypeAliases.js'\n\n/**\n * Keys of `BUILT_IN_WIDGETS` — the v2 manifest widget set.\n *\n * Kept in the registry's own declaration order so a diff against\n * `builtInWidgets.js` reads straight down.\n *\n * @type {string[]} Frozen.\n */\nexport const BUILT_IN_WIDGET_KEYS = Object.freeze([\n\t'object-table',\n\t'form-renderer',\n\t'map-viewer',\n\t'object-geo',\n\t'card-grid',\n\t'nav-card-grid',\n\t'data',\n\t'metadata',\n\t'related',\n\t'integration',\n\t'banner',\n\t'audit-trail',\n\t'timeline',\n\t'header',\n\t'text',\n\t'divider',\n])\n\n/**\n * Widget types the LIBRARY registers into the dashboard catalog at import time\n * (`registerDashboardWidgets.js` and the widget `index.js` modules it pulls in).\n *\n * Deliberately a static list rather than a read of `dashboardWidgetRegistry`:\n * that object is mutable and consumer-extensible, so deriving the exemption\n * from it at call time would let an app register its own full-page component in\n * the catalog and walk straight through the ADR-036 Decision 1 rule the\n * exemption exists to enforce. Only keys the library itself ships are exempt.\n *\n * Sorted, because unlike `BUILT_IN_WIDGETS` these registrations are spread over\n * ~30 files and have no meaningful declaration order.\n *\n * @type {string[]} Frozen.\n */\nexport const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([\n\t'audit-trail',\n\t'banner',\n\t'calendar',\n\t'chart',\n\t'container',\n\t'conversation',\n\t'countdown',\n\t'data',\n\t'delta',\n\t'divider',\n\t'document-review',\n\t'files',\n\t'flow-runs',\n\t'gauge',\n\t'header',\n\t'image',\n\t'interaction-form',\n\t'kb-search',\n\t'label',\n\t'link',\n\t'links',\n\t'map',\n\t'markdown',\n\t'menu',\n\t'nc-widget',\n\t'next-step',\n\t'notepad',\n\t// `news` was here until the widget moved to LaunchPad, which owns the feed\n\t// fetching. An app that renders one now gets it from LaunchPad's registry.\n\t'object-geo',\n\t'object-list',\n\t'object-table',\n\t'people',\n\t'quicklinks',\n\t'related',\n\t'saved-view',\n\t'spend-analytics',\n\t'stacked-bar',\n\t'stages',\n\t'stat',\n\t'stats-block',\n\t'table',\n\t'tabs',\n\t'tasks',\n\t'text',\n\t'tile',\n\t'timeline',\n\t'video',\n\t'week-strip',\n\t'workspace-filter',\n])\n\n/**\n * Expand a key set over `WIDGET_TYPE_ALIASES` so both spellings of an aliased\n * widget are present whenever either one is.\n *\n * `CnWidgetGrid` resolves a key and its canonical form (`object-table` ⇄\n * `table`, `map-viewer` ⇄ `map`), so both spellings render and both must be\n * exempt. Today each registry happens to hold one side of each pair, which is\n * exactly the accident that would silently stop being true when the next alias\n * lands.\n *\n * @param {Set<string>} keys The key set to expand, mutated in place.\n * @return {Set<string>} The same set.\n */\nfunction expandAliases(keys) {\n\tfor (const [alias, canonical] of Object.entries(WIDGET_TYPE_ALIASES)) {\n\t\tif (keys.has(alias) || keys.has(canonical)) {\n\t\t\tkeys.add(alias)\n\t\t\tkeys.add(canonical)\n\t\t}\n\t}\n\treturn keys\n}\n\n/**\n * Every widget key the library renders itself: both registries, plus both\n * spellings of every alias.\n *\n * A `widgetKey` in this list is served by a library `Cn*` SFC and does NOT\n * count as a custom registry component for the single-12×12-widget dashboard\n * rule (ADR-036 Decision 1).\n *\n * @type {string[]} Frozen.\n */\nexport const LIBRARY_WIDGET_KEYS = Object.freeze([\n\t...expandAliases(new Set([\n\t\t...BUILT_IN_WIDGET_KEYS,\n\t\t...DASHBOARD_CATALOG_WIDGET_KEYS,\n\t])),\n])\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAClD,CAAC,cAAc;AACf,CAAC,eAAe;AAChB,CAAC,YAAY;AACb,CAAC,YAAY;AACb,CAAC,WAAW;AACZ,CAAC,eAAe;AAChB,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,SAAS;AACV,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,SAAS;AACV,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;AAC3D,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,UAAU;AACX,CAAC,OAAO;AACR,CAAC,WAAW;AACZ,CAAC,cAAc;AACf,CAAC,WAAW;AACZ,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,SAAS;AACV,CAAC,iBAAiB;AAClB,CAAC,OAAO;AACR,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,QAAQ;AACT,CAAC,OAAO;AACR,CAAC,kBAAkB;AACnB,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,KAAK;AACN,CAAC,UAAU;AACX,CAAC,MAAM;AACP,CAAC,WAAW;AACZ,CAAC,WAAW;AACZ,CAAC,SAAS;AACV;AACA;AACA,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,cAAc;AACf,CAAC,QAAQ;AACT,CAAC,YAAY;AACb,CAAC,SAAS;AACV,CAAC,YAAY;AACb,CAAC,iBAAiB;AAClB,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,aAAa;AACd,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,kBAAkB;AACnB,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,IAAI,EAAE;AAC7B,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;AACvE,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AAC9C,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAC;AAClB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAC;AACtB,GAAG;AACH,EAAE;AACF,CAAC,OAAO,IAAI;AACZ,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;AACjD,CAAC,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC;AAC1B,EAAE,GAAG,oBAAoB;AACzB,EAAE,GAAG,6BAA6B;AAClC,EAAE,CAAC,CAAC;AACJ,CAAC;;;;"}
+{"version":3,"file":"libraryWidgetKeys.js","sources":["../../../src/utils/libraryWidgetKeys.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * libraryWidgetKeys — the one vocabulary of widget keys the LIBRARY itself\n * renders, and the only list `validateManifestV2` is allowed to consult.\n *\n * WHY THIS MODULE EXISTS\n * ----------------------\n * The validator used to carry its own hand-written array of \"library built-in\n * widget keys\", with a comment instructing whoever added a built-in to append\n * it \"in the same PR\". That instruction was followed for five keys and missed\n * for six, so the validator knew 11 keys while the library actually rendered\n * 45. Nothing failed when the two disagreed, because the only consumer is an\n * exemption: a key the validator does not recognise is treated as a CUSTOM\n * registry component, which makes a legitimate single-widget library dashboard\n * fail the ADR-036 Decision 1 anti-pattern rule with advice (\"declare it as\n * type:'custom'\") that is wrong for a library widget.\n *\n * A comment cannot enforce anything, so the array moved here and\n * `tests/utils/libraryWidgetKeys.spec.js` now binds it to the two registries\n * that actually resolve a key at runtime:\n *\n *   1. `BUILT_IN_WIDGETS` (components/CnWidgetGrid/builtInWidgets.js) — the v2\n *      manifest widget set `CnWidgetGrid` resolves a `widgetKey` against.\n *   2. The dashboard widget catalog (`dashboardWidgetRegistry`), populated by\n *      `registerDashboardWidgets.js`. `CnWidgetGrid` falls back to it (third in\n *      the chain, after the consumer registry and `BUILT_IN_WIDGETS`), so a\n *      catalog key renders on a v2 page exactly like a `BUILT_IN_WIDGETS` one.\n *\n * The test asserts SET EQUALITY in both directions against the live registries,\n * so adding a widget to either registry without touching this file fails CI,\n * and deleting one without removing it here fails too. The lists below are the\n * validator's view; the registries are the truth the test holds them to.\n *\n * THE CATALOG IS NOT LEGACY. It is a live half of the same vocabulary, and the\n * old array already conceded the point by exempting `chart` and `stats-block`,\n * which are catalog-only keys that `BUILT_IN_WIDGETS` has never held. What it\n * got wrong was doing that for two keys and not the other thirty-seven.\n * `widgetDispatch.js` unified the two resolution paths for the same reason: a\n * widget authored against one vocabulary was invisible to the other and said\n * nothing about why (101 of 236 detail widgets on hrmq).\n *\n * @module utils/libraryWidgetKeys\n */\n\nimport { WIDGET_TYPE_ALIASES } from './widgetTypeAliases.js'\n\n/**\n * Keys of `BUILT_IN_WIDGETS` — the v2 manifest widget set.\n *\n * Kept in the registry's own declaration order so a diff against\n * `builtInWidgets.js` reads straight down.\n *\n * @type {string[]} Frozen.\n */\nexport const BUILT_IN_WIDGET_KEYS = Object.freeze([\n\t'object-table',\n\t'form-renderer',\n\t'map-viewer',\n\t'object-geo',\n\t'card-grid',\n\t'nav-card-grid',\n\t'data',\n\t'metadata',\n\t'related',\n\t'integration',\n\t'banner',\n\t'audit-trail',\n\t'timeline',\n\t'header',\n\t'text',\n\t'divider',\n])\n\n/**\n * Widget types the LIBRARY registers into the dashboard catalog at import time\n * (`registerDashboardWidgets.js` and the widget `index.js` modules it pulls in).\n *\n * Deliberately a static list rather than a read of `dashboardWidgetRegistry`:\n * that object is mutable and consumer-extensible, so deriving the exemption\n * from it at call time would let an app register its own full-page component in\n * the catalog and walk straight through the ADR-036 Decision 1 rule the\n * exemption exists to enforce. Only keys the library itself ships are exempt.\n *\n * Sorted, because unlike `BUILT_IN_WIDGETS` these registrations are spread over\n * ~30 files and have no meaningful declaration order.\n *\n * @type {string[]} Frozen.\n */\nexport const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([\n\t'audit-trail',\n\t'banner',\n\t'calendar',\n\t'chart',\n\t'chips-field',\n\t'choice-picker',\n\t'container',\n\t'conversation',\n\t'countdown',\n\t'data',\n\t'delta',\n\t'divider',\n\t'document-review',\n\t'facts',\n\t'field-list',\n\t'files',\n\t'flow-runs',\n\t'gauge',\n\t'header',\n\t'image',\n\t'interaction-form',\n\t'kb-search',\n\t'label',\n\t'link',\n\t'links',\n\t'map',\n\t'markdown',\n\t'menu',\n\t'nc-widget',\n\t'next-step',\n\t'notepad',\n\t// `news` was here until the widget moved to LaunchPad, which owns the feed\n\t// fetching. An app that renders one now gets it from LaunchPad's registry.\n\t'object-geo',\n\t'object-list',\n\t'object-table',\n\t'people',\n\t'quicklinks',\n\t'radio-cards',\n\t'record-list',\n\t'related',\n\t'saved-view',\n\t'saved-views',\n\t'sections',\n\t'settings-form',\n\t'spend-analytics',\n\t'stacked-bar',\n\t'stages',\n\t'stat',\n\t'stats-block',\n\t'switch-rows',\n\t'table',\n\t'tabs',\n\t'tasks',\n\t'text',\n\t'tile',\n\t'timeline',\n\t'toggle-table',\n\t'video',\n\t'week-strip',\n\t'workspace-filter',\n])\n\n/**\n * Expand a key set over `WIDGET_TYPE_ALIASES` so both spellings of an aliased\n * widget are present whenever either one is.\n *\n * `CnWidgetGrid` resolves a key and its canonical form (`object-table` ⇄\n * `table`, `map-viewer` ⇄ `map`), so both spellings render and both must be\n * exempt. Today each registry happens to hold one side of each pair, which is\n * exactly the accident that would silently stop being true when the next alias\n * lands.\n *\n * @param {Set<string>} keys The key set to expand, mutated in place.\n * @return {Set<string>} The same set.\n */\nfunction expandAliases(keys) {\n\tfor (const [alias, canonical] of Object.entries(WIDGET_TYPE_ALIASES)) {\n\t\tif (keys.has(alias) || keys.has(canonical)) {\n\t\t\tkeys.add(alias)\n\t\t\tkeys.add(canonical)\n\t\t}\n\t}\n\treturn keys\n}\n\n/**\n * Every widget key the library renders itself: both registries, plus both\n * spellings of every alias.\n *\n * A `widgetKey` in this list is served by a library `Cn*` SFC and does NOT\n * count as a custom registry component for the single-12×12-widget dashboard\n * rule (ADR-036 Decision 1).\n *\n * @type {string[]} Frozen.\n */\nexport const LIBRARY_WIDGET_KEYS = Object.freeze([\n\t...expandAliases(new Set([\n\t\t...BUILT_IN_WIDGET_KEYS,\n\t\t...DASHBOARD_CATALOG_WIDGET_KEYS,\n\t])),\n])\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;AAClD,CAAC,cAAc;AACf,CAAC,eAAe;AAChB,CAAC,YAAY;AACb,CAAC,YAAY;AACb,CAAC,WAAW;AACZ,CAAC,eAAe;AAChB,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,SAAS;AACV,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,SAAS;AACV,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC;AAC3D,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,UAAU;AACX,CAAC,OAAO;AACR,CAAC,aAAa;AACd,CAAC,eAAe;AAChB,CAAC,WAAW;AACZ,CAAC,cAAc;AACf,CAAC,WAAW;AACZ,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,SAAS;AACV,CAAC,iBAAiB;AAClB,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,OAAO;AACR,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,QAAQ;AACT,CAAC,OAAO;AACR,CAAC,kBAAkB;AACnB,CAAC,WAAW;AACZ,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,KAAK;AACN,CAAC,UAAU;AACX,CAAC,MAAM;AACP,CAAC,WAAW;AACZ,CAAC,WAAW;AACZ,CAAC,SAAS;AACV;AACA;AACA,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,cAAc;AACf,CAAC,QAAQ;AACT,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,aAAa;AACd,CAAC,SAAS;AACV,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,UAAU;AACX,CAAC,eAAe;AAChB,CAAC,iBAAiB;AAClB,CAAC,aAAa;AACd,CAAC,QAAQ;AACT,CAAC,MAAM;AACP,CAAC,aAAa;AACd,CAAC,aAAa;AACd,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,OAAO;AACR,CAAC,MAAM;AACP,CAAC,MAAM;AACP,CAAC,UAAU;AACX,CAAC,cAAc;AACf,CAAC,OAAO;AACR,CAAC,YAAY;AACb,CAAC,kBAAkB;AACnB,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,aAAa,CAAC,IAAI,EAAE;AAC7B,CAAC,KAAK,MAAM,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,mBAAmB,CAAC,EAAE;AACvE,EAAE,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE;AAC9C,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAC;AAClB,GAAG,IAAI,CAAC,GAAG,CAAC,SAAS,EAAC;AACtB,GAAG;AACH,EAAE;AACF,CAAC,OAAO,IAAI;AACZ,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,mBAAmB,GAAG,MAAM,CAAC,MAAM,CAAC;AACjD,CAAC,GAAG,aAAa,CAAC,IAAI,GAAG,CAAC;AAC1B,EAAE,GAAG,oBAAoB;AACzB,EAAE,GAAG,6BAA6B;AAClC,EAAE,CAAC,CAAC;AACJ,CAAC;;;;"}

package/dist/esm/utils/objectWrite.js

@@ -0,0 +1,59 @@
+import { prefixUrl } from './headers.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * objectWrite: the one-object PATCH the settings widgets share.
+ *
+ * @module utils/objectWrite
+ */
+
+
+/**
+ * The OpenRegister URL of one object, or '' when register, schema or id is missing.
+ *
+ * @param {string|object} register Register slug.
+ * @param {string|object} schema Schema slug.
+ * @param {string|number} id Object id.
+ * @return {string} The object URL.
+ */
+function objectUrlOf(register, schema, id) {
+	if (typeof register !== 'string' || typeof schema !== 'string' || !register || !schema || id === undefined || id === null || id === '') {
+		return ''
+	}
+	return `/apps/openregister/api/objects/${encodeURIComponent(register)}/${encodeURIComponent(schema)}/${encodeURIComponent(String(id))}`
+}
+
+/**
+ * PATCH only the given fields of one object.
+ *
+ * @param {string} url The object URL (see objectUrlOf).
+ * @param {object} patch The fields to write.
+ * @return {Promise<object>} The object the server answered with.
+ */
+async function patchObject(url, patch) {
+	const { default: axios } = await import('@nextcloud/axios');
+	const { data } = await axios.patch(prefixUrl(url), patch);
+	return data && typeof data === 'object' ? data : {}
+}
+
+/**
+ * The fields of `next` that differ from `base`, compared by value.
+ *
+ * @param {object} base What the server last held.
+ * @param {object} next What the form holds.
+ * @return {object} The changed fields only.
+ */
+function changedFields(base, next) {
+	const patch = {};
+	for (const [key, value] of Object.entries(next)) {
+		if (JSON.stringify(value === undefined ? null : value) !== JSON.stringify(base[key] === undefined ? null : base[key])) {
+			patch[key] = value;
+		}
+	}
+	return patch
+}
+
+export { changedFields, objectUrlOf, patchObject };
+//# sourceMappingURL=objectWrite.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"objectWrite.js","sources":["../../../src/utils/objectWrite.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * objectWrite: the one-object PATCH the settings widgets share.\n *\n * @module utils/objectWrite\n */\n\nimport { prefixUrl } from './headers.js'\n\n/**\n * The OpenRegister URL of one object, or '' when register, schema or id is missing.\n *\n * @param {string|object} register Register slug.\n * @param {string|object} schema Schema slug.\n * @param {string|number} id Object id.\n * @return {string} The object URL.\n */\nexport function objectUrlOf(register, schema, id) {\n\tif (typeof register !== 'string' || typeof schema !== 'string' || !register || !schema || id === undefined || id === null || id === '') {\n\t\treturn ''\n\t}\n\treturn `/apps/openregister/api/objects/${encodeURIComponent(register)}/${encodeURIComponent(schema)}/${encodeURIComponent(String(id))}`\n}\n\n/**\n * PATCH only the given fields of one object.\n *\n * @param {string} url The object URL (see objectUrlOf).\n * @param {object} patch The fields to write.\n * @return {Promise<object>} The object the server answered with.\n */\nexport async function patchObject(url, patch) {\n\tconst { default: axios } = await import('@nextcloud/axios')\n\tconst { data } = await axios.patch(prefixUrl(url), patch)\n\treturn data && typeof data === 'object' ? data : {}\n}\n\n/**\n * The fields of `next` that differ from `base`, compared by value.\n *\n * @param {object} base What the server last held.\n * @param {object} next What the form holds.\n * @return {object} The changed fields only.\n */\nexport function changedFields(base, next) {\n\tconst patch = {}\n\tfor (const [key, value] of Object.entries(next)) {\n\t\tif (JSON.stringify(value === undefined ? null : value) !== JSON.stringify(base[key] === undefined ? null : base[key])) {\n\t\t\tpatch[key] = value\n\t\t}\n\t}\n\treturn patch\n}\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;AAClD,CAAC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,IAAI,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,IAAI,IAAI,EAAE,KAAK,EAAE,EAAE;AACzI,EAAE,OAAO,EAAE;AACX,EAAE;AACF,CAAC,OAAO,CAAC,+BAA+B,EAAE,kBAAkB,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,kBAAkB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxI,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,WAAW,CAAC,GAAG,EAAE,KAAK,EAAE;AAC9C,CAAC,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,OAAO,kBAAkB,EAAC;AAC5D,CAAC,MAAM,EAAE,IAAI,EAAE,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,KAAK,EAAC;AAC1D,CAAC,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,GAAG,IAAI,GAAG,EAAE;AACpD,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE;AAC1C,CAAC,MAAM,KAAK,GAAG,GAAE;AACjB,CAAC,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE;AAClD,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,KAAK,KAAK,SAAS,GAAG,IAAI,GAAG,KAAK,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,SAAS,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE;AACzH,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,MAAK;AACrB,GAAG;AACH,EAAE;AACF,CAAC,OAAO,KAAK;AACb;;;;"}

package/dist/esm/utils/pageControls.js

@@ -0,0 +1,81 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * pageControls: how a list widget listens to the page's controls.
+ *
+ * A page control (a `workspace-filter` select or switch) writes a value to the
+ * page workspace. A list widget declares which control it listens to and what
+ * the value means for it:
+ *
+ *   pageControls: {
+ *     sort:   { key: "sort", map: { deadline: { field: "slaDeadline", dir: "asc" } } },
+ *     toggle: { key: "showDone", removes: ["status"] }
+ *   }
+ *
+ * `sort`: the workspace value at `key` picks an entry of `map` (the sort the
+ * list uses); a value with no entry leaves the list's own sort.
+ * `toggle`: while the workspace value at `key` is on (true, "1", "true"), the
+ * filter keys in `removes` are dropped, so a list that hides finished work
+ * shows it.
+ *
+ * @module utils/pageControls
+ */
+
+/**
+ * Whether a workspace value reads as on.
+ *
+ * @param {unknown} value The value.
+ * @return {boolean} True for true, 1, "1" and "true".
+ */
+function isOn(value) {
+	return value === true || value === 1 || value === '1' || value === 'true'
+}
+
+/**
+ * The sort a list uses once the page's sort control is read.
+ *
+ * @param {object|null} pageControls The widget's `pageControls`.
+ * @param {object} workspace The plain workspace bag.
+ * @param {{field: string, dir?: string}|null} own The list's own sort.
+ * @return {{field: string, dir?: string}|null} The sort to use.
+ * @spec openspec/changes/screens-page-controls/specs/page-controls/spec.md#requirement-a-list-listens-to-the-pages-controls
+ */
+function pageSort(pageControls, workspace, own) {
+	const listen = pageControls && typeof pageControls === 'object' ? pageControls.sort : null;
+	if (!listen || typeof listen.key !== 'string' || !listen.map || typeof listen.map !== 'object') {
+		return own
+	}
+	const chosen = workspace ? workspace[listen.key] : undefined;
+	const entry = chosen !== undefined && chosen !== null ? listen.map[String(chosen)] : null;
+	return entry && typeof entry === 'object' && typeof entry.field === 'string' && entry.field !== '' ? entry : own
+}
+
+/**
+ * The filter a list uses once the page's toggle is read: with the toggle on,
+ * the keys it `removes` are gone.
+ *
+ * @param {object|null} pageControls The widget's `pageControls`.
+ * @param {object} workspace The plain workspace bag.
+ * @param {object} filter The list's own filter (before token resolution).
+ * @return {object} The filter to use (the same object when nothing is removed).
+ * @spec openspec/changes/screens-page-controls/specs/page-controls/spec.md#requirement-a-list-listens-to-the-pages-controls
+ */
+function pageFilter(pageControls, workspace, filter) {
+	const listen = pageControls && typeof pageControls === 'object' ? pageControls.toggle : null;
+	const base = filter && typeof filter === 'object' ? filter : {};
+	if (!listen || typeof listen.key !== 'string' || !Array.isArray(listen.removes)) {
+		return base
+	}
+	if (!isOn(workspace ? workspace[listen.key] : undefined)) {
+		return base
+	}
+	const out = { ...base };
+	for (const key of listen.removes) {
+		delete out[key];
+	}
+	return out
+}
+
+export { isOn, pageFilter, pageSort };
+//# sourceMappingURL=pageControls.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pageControls.js","sources":["../../../src/utils/pageControls.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * pageControls: how a list widget listens to the page's controls.\n *\n * A page control (a `workspace-filter` select or switch) writes a value to the\n * page workspace. A list widget declares which control it listens to and what\n * the value means for it:\n *\n *   pageControls: {\n *     sort:   { key: \"sort\", map: { deadline: { field: \"slaDeadline\", dir: \"asc\" } } },\n *     toggle: { key: \"showDone\", removes: [\"status\"] }\n *   }\n *\n * `sort`: the workspace value at `key` picks an entry of `map` (the sort the\n * list uses); a value with no entry leaves the list's own sort.\n * `toggle`: while the workspace value at `key` is on (true, \"1\", \"true\"), the\n * filter keys in `removes` are dropped, so a list that hides finished work\n * shows it.\n *\n * @module utils/pageControls\n */\n\n/**\n * Whether a workspace value reads as on.\n *\n * @param {unknown} value The value.\n * @return {boolean} True for true, 1, \"1\" and \"true\".\n */\nexport function isOn(value) {\n\treturn value === true || value === 1 || value === '1' || value === 'true'\n}\n\n/**\n * The sort a list uses once the page's sort control is read.\n *\n * @param {object|null} pageControls The widget's `pageControls`.\n * @param {object} workspace The plain workspace bag.\n * @param {{field: string, dir?: string}|null} own The list's own sort.\n * @return {{field: string, dir?: string}|null} The sort to use.\n * @spec openspec/changes/screens-page-controls/specs/page-controls/spec.md#requirement-a-list-listens-to-the-pages-controls\n */\nexport function pageSort(pageControls, workspace, own) {\n\tconst listen = pageControls && typeof pageControls === 'object' ? pageControls.sort : null\n\tif (!listen || typeof listen.key !== 'string' || !listen.map || typeof listen.map !== 'object') {\n\t\treturn own\n\t}\n\tconst chosen = workspace ? workspace[listen.key] : undefined\n\tconst entry = chosen !== undefined && chosen !== null ? listen.map[String(chosen)] : null\n\treturn entry && typeof entry === 'object' && typeof entry.field === 'string' && entry.field !== '' ? entry : own\n}\n\n/**\n * The filter a list uses once the page's toggle is read: with the toggle on,\n * the keys it `removes` are gone.\n *\n * @param {object|null} pageControls The widget's `pageControls`.\n * @param {object} workspace The plain workspace bag.\n * @param {object} filter The list's own filter (before token resolution).\n * @return {object} The filter to use (the same object when nothing is removed).\n * @spec openspec/changes/screens-page-controls/specs/page-controls/spec.md#requirement-a-list-listens-to-the-pages-controls\n */\nexport function pageFilter(pageControls, workspace, filter) {\n\tconst listen = pageControls && typeof pageControls === 'object' ? pageControls.toggle : null\n\tconst base = filter && typeof filter === 'object' ? filter : {}\n\tif (!listen || typeof listen.key !== 'string' || !Array.isArray(listen.removes)) {\n\t\treturn base\n\t}\n\tif (!isOn(workspace ? workspace[listen.key] : undefined)) {\n\t\treturn base\n\t}\n\tconst out = { ...base }\n\tfor (const key of listen.removes) {\n\t\tdelete out[key]\n\t}\n\treturn out\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,IAAI,CAAC,KAAK,EAAE;AAC5B,CAAC,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,CAAC,IAAI,KAAK,KAAK,GAAG,IAAI,KAAK,KAAK,MAAM;AAC1E,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,QAAQ,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,EAAE;AACvD,CAAC,MAAM,MAAM,GAAG,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,GAAG,YAAY,CAAC,IAAI,GAAG,KAAI;AAC3F,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,EAAE;AACjG,EAAE,OAAO,GAAG;AACZ,EAAE;AACF,CAAC,MAAM,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,UAAS;AAC7D,CAAC,MAAM,KAAK,GAAG,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,KAAI;AAC1F,CAAC,OAAO,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,CAAC,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,KAAK,KAAK,EAAE,GAAG,KAAK,GAAG,GAAG;AACjH,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,UAAU,CAAC,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE;AAC5D,CAAC,MAAM,MAAM,GAAG,YAAY,IAAI,OAAO,YAAY,KAAK,QAAQ,GAAG,YAAY,CAAC,MAAM,GAAG,KAAI;AAC7F,CAAC,MAAM,IAAI,GAAG,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,GAAG,MAAM,GAAG,GAAE;AAChE,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;AAClF,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,EAAE;AAC3D,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,GAAE;AACxB,CAAC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,OAAO,EAAE;AACnC,EAAE,OAAO,GAAG,CAAC,GAAG,EAAC;AACjB,EAAE;AACF,CAAC,OAAO,GAAG;AACX;;;;"}

package/dist/esm/utils/personalLenses.js

@@ -38,6 +38,42 @@ function personalLensTabs(lenses) {
 		.map((id) => ({ label: labels[id], filter: { [LENS_FILTER_KEYS[id]]: true }, lens: id }))
 }
 
+/**
+ * Turn the `empty` / `notEmpty` shorthand of quick filters into a filter.
+ *
+ * `{ label: "Not logged in yet", empty: "lastLoginAt" }` is the rows where the
+ * field has no value: the filter `{ lastLoginAt: { isnull: true } }`, which
+ * OpenRegister reads as `lastLoginAt[isnull]=true`. `notEmpty` is the rows
+ * where it has one. Either takes a field or a list of fields and merges with
+ * the entry's own `filter`. Returns the same array when no entry uses it.
+ *
+ * @param {Array<object>|null} quickFilters The page's quick filters.
+ * @return {Array<object>|null} The quick filters with the shorthand expanded.
+ */
+function expandEmptyFilters(quickFilters) {
+	if (!Array.isArray(quickFilters)) {
+		return quickFilters
+	}
+	const uses = (tab) => tab && typeof tab === 'object' && (tab.empty || tab.notEmpty);
+	if (!quickFilters.some(uses)) {
+		return quickFilters
+	}
+	const fieldsOf = (value) => (Array.isArray(value) ? value : [value]).filter((f) => typeof f === 'string' && f !== '');
+	return quickFilters.map((tab) => {
+		if (!uses(tab)) {
+			return tab
+		}
+		const filter = { ...(tab.filter && typeof tab.filter === 'object' ? tab.filter : {}) };
+		for (const field of fieldsOf(tab.empty)) {
+			filter[field] = { isnull: true };
+		}
+		for (const field of fieldsOf(tab.notEmpty)) {
+			filter[field] = { isnull: false };
+		}
+		return { ...tab, filter }
+	})
+}
+
 /**
  * The page's quick filters with its personal lenses appended. A page with no
  * quick filters of its own gets an "All" tab first, so a lens is not active
@@ -49,14 +85,15 @@ function personalLensTabs(lenses) {
  */
 function withPersonalLenses(quickFilters, lenses) {
 	const tabs = personalLensTabs(lenses);
+	const expanded = expandEmptyFilters(quickFilters);
 	if (tabs.length === 0) {
-		return quickFilters
+		return expanded
 	}
-	const own = Array.isArray(quickFilters) ? quickFilters : [];
+	const own = Array.isArray(expanded) ? expanded : [];
 	return own.length > 0
 		? [...own, ...tabs]
 		: [{ label: translate('nextcloud-vue', 'All'), filter: {}, default: true }, ...tabs]
 }
 
-export { LENS_FILTER_KEYS, personalLensTabs, withPersonalLenses };
+export { LENS_FILTER_KEYS, expandEmptyFilters, personalLensTabs, withPersonalLenses };
 //# sourceMappingURL=personalLenses.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"personalLenses.js","sources":["../../../src/utils/personalLenses.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * The personal lenses of an index page (Following, Recent, Unread) as quick\n * filters, appended after the page's own.\n *\n * There is no Favourites lens any more: a favourite is a follow with\n * notifications off (OpenRegister `merge-follow-and-favourites`), so\n * `favourite` is an alias of `watching` and asking for both gives one tab.\n *\n * @spec openspec/changes/one-follow-control/specs/record-follow/spec.md#requirement-index-pages-offer-one-following-lens-and-a-follow-column\n */\nimport { translate as t } from '@nextcloud/l10n'\n\n/** Lens id to the query key OpenRegister reads. */\nexport const LENS_FILTER_KEYS = { recent: '_recent', watching: '_watching', unread: '_unread' }\n\n/** Deprecated lens ids and the lens they now mean. */\nconst LENS_ALIASES = { favourite: 'watching' }\n\n/**\n * Quick filters for the requested lenses. Unknown ids are ignored.\n *\n * @param {string[]} lenses Any of `watching`, `recent`, `unread`, and the deprecated `favourite` (read as `watching`).\n * @return {Array<{label: string, filter: object, lens: string}>} One tab per lens, in the order asked.\n */\nexport function personalLensTabs(lenses) {\n\tconst labels = {\n\t\trecent: t('nextcloud-vue', 'Recent'),\n\t\twatching: t('nextcloud-vue', 'Following'),\n\t\tunread: t('nextcloud-vue', 'Unread'),\n\t}\n\treturn (Array.isArray(lenses) ? lenses : [])\n\t\t.map((id) => (Object.hasOwn(LENS_ALIASES, id) ? LENS_ALIASES[id] : id))\n\t\t.filter((id, i, all) => Object.hasOwn(LENS_FILTER_KEYS, id) && all.indexOf(id) === i)\n\t\t.map((id) => ({ label: labels[id], filter: { [LENS_FILTER_KEYS[id]]: true }, lens: id }))\n}\n\n/**\n * The page's quick filters with its personal lenses appended. A page with no\n * quick filters of its own gets an \"All\" tab first, so a lens is not active\n * before the person asks for it.\n *\n * @param {Array<object>|null} quickFilters The page's own quick filters.\n * @param {string[]}           lenses       The requested lenses.\n * @return {Array<object>|null} The combined list, or the page's own list unchanged when no lens is asked for.\n */\nexport function withPersonalLenses(quickFilters, lenses) {\n\tconst tabs = personalLensTabs(lenses)\n\tif (tabs.length === 0) {\n\t\treturn quickFilters\n\t}\n\tconst own = Array.isArray(quickFilters) ? quickFilters : []\n\treturn own.length > 0\n\t\t? [...own, ...tabs]\n\t\t: [{ label: t('nextcloud-vue', 'All'), filter: {}, default: true }, ...tabs]\n}\n"],"names":["t"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACY,MAAC,gBAAgB,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE;AAC/F;AACA;AACA,MAAM,YAAY,GAAG,EAAE,SAAS,EAAE,UAAU,GAAE;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,MAAM,EAAE;AACzC,CAAC,MAAM,MAAM,GAAG;AAChB,EAAE,MAAM,EAAEA,SAAC,CAAC,eAAe,EAAE,QAAQ,CAAC;AACtC,EAAE,QAAQ,EAAEA,SAAC,CAAC,eAAe,EAAE,WAAW,CAAC;AAC3C,EAAE,MAAM,EAAEA,SAAC,CAAC,eAAe,EAAE,QAAQ,CAAC;AACtC,GAAE;AACF,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,EAAE;AAC5C,GAAG,GAAG,CAAC,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AACzE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACvF,GAAG,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE;AACzD,CAAC,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAC;AACtC,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACxB,EAAE,OAAO,YAAY;AACrB,EAAE;AACF,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,GAAG,GAAE;AAC5D,CAAC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC;AACtB,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;AACrB,IAAI,CAAC,EAAE,KAAK,EAAEA,SAAC,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC;AAC9E;;;;"}
+{"version":3,"file":"personalLenses.js","sources":["../../../src/utils/personalLenses.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * The personal lenses of an index page (Following, Recent, Unread) as quick\n * filters, appended after the page's own.\n *\n * There is no Favourites lens any more: a favourite is a follow with\n * notifications off (OpenRegister `merge-follow-and-favourites`), so\n * `favourite` is an alias of `watching` and asking for both gives one tab.\n *\n * @spec openspec/changes/one-follow-control/specs/record-follow/spec.md#requirement-index-pages-offer-one-following-lens-and-a-follow-column\n */\nimport { translate as t } from '@nextcloud/l10n'\n\n/** Lens id to the query key OpenRegister reads. */\nexport const LENS_FILTER_KEYS = { recent: '_recent', watching: '_watching', unread: '_unread' }\n\n/** Deprecated lens ids and the lens they now mean. */\nconst LENS_ALIASES = { favourite: 'watching' }\n\n/**\n * Quick filters for the requested lenses. Unknown ids are ignored.\n *\n * @param {string[]} lenses Any of `watching`, `recent`, `unread`, and the deprecated `favourite` (read as `watching`).\n * @return {Array<{label: string, filter: object, lens: string}>} One tab per lens, in the order asked.\n */\nexport function personalLensTabs(lenses) {\n\tconst labels = {\n\t\trecent: t('nextcloud-vue', 'Recent'),\n\t\twatching: t('nextcloud-vue', 'Following'),\n\t\tunread: t('nextcloud-vue', 'Unread'),\n\t}\n\treturn (Array.isArray(lenses) ? lenses : [])\n\t\t.map((id) => (Object.hasOwn(LENS_ALIASES, id) ? LENS_ALIASES[id] : id))\n\t\t.filter((id, i, all) => Object.hasOwn(LENS_FILTER_KEYS, id) && all.indexOf(id) === i)\n\t\t.map((id) => ({ label: labels[id], filter: { [LENS_FILTER_KEYS[id]]: true }, lens: id }))\n}\n\n/**\n * Turn the `empty` / `notEmpty` shorthand of quick filters into a filter.\n *\n * `{ label: \"Not logged in yet\", empty: \"lastLoginAt\" }` is the rows where the\n * field has no value: the filter `{ lastLoginAt: { isnull: true } }`, which\n * OpenRegister reads as `lastLoginAt[isnull]=true`. `notEmpty` is the rows\n * where it has one. Either takes a field or a list of fields and merges with\n * the entry's own `filter`. Returns the same array when no entry uses it.\n *\n * @param {Array<object>|null} quickFilters The page's quick filters.\n * @return {Array<object>|null} The quick filters with the shorthand expanded.\n */\nexport function expandEmptyFilters(quickFilters) {\n\tif (!Array.isArray(quickFilters)) {\n\t\treturn quickFilters\n\t}\n\tconst uses = (tab) => tab && typeof tab === 'object' && (tab.empty || tab.notEmpty)\n\tif (!quickFilters.some(uses)) {\n\t\treturn quickFilters\n\t}\n\tconst fieldsOf = (value) => (Array.isArray(value) ? value : [value]).filter((f) => typeof f === 'string' && f !== '')\n\treturn quickFilters.map((tab) => {\n\t\tif (!uses(tab)) {\n\t\t\treturn tab\n\t\t}\n\t\tconst filter = { ...(tab.filter && typeof tab.filter === 'object' ? tab.filter : {}) }\n\t\tfor (const field of fieldsOf(tab.empty)) {\n\t\t\tfilter[field] = { isnull: true }\n\t\t}\n\t\tfor (const field of fieldsOf(tab.notEmpty)) {\n\t\t\tfilter[field] = { isnull: false }\n\t\t}\n\t\treturn { ...tab, filter }\n\t})\n}\n\n/**\n * The page's quick filters with its personal lenses appended. A page with no\n * quick filters of its own gets an \"All\" tab first, so a lens is not active\n * before the person asks for it.\n *\n * @param {Array<object>|null} quickFilters The page's own quick filters.\n * @param {string[]}           lenses       The requested lenses.\n * @return {Array<object>|null} The combined list, or the page's own list unchanged when no lens is asked for.\n */\nexport function withPersonalLenses(quickFilters, lenses) {\n\tconst tabs = personalLensTabs(lenses)\n\tconst expanded = expandEmptyFilters(quickFilters)\n\tif (tabs.length === 0) {\n\t\treturn expanded\n\t}\n\tconst own = Array.isArray(expanded) ? expanded : []\n\treturn own.length > 0\n\t\t? [...own, ...tabs]\n\t\t: [{ label: t('nextcloud-vue', 'All'), filter: {}, default: true }, ...tabs]\n}\n"],"names":["t"],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACY,MAAC,gBAAgB,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,GAAE;AAC/F;AACA;AACA,MAAM,YAAY,GAAG,EAAE,SAAS,EAAE,UAAU,GAAE;AAC9C;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,MAAM,EAAE;AACzC,CAAC,MAAM,MAAM,GAAG;AAChB,EAAE,MAAM,EAAEA,SAAC,CAAC,eAAe,EAAE,QAAQ,CAAC;AACtC,EAAE,QAAQ,EAAEA,SAAC,CAAC,eAAe,EAAE,WAAW,CAAC;AAC3C,EAAE,MAAM,EAAEA,SAAC,CAAC,eAAe,EAAE,QAAQ,CAAC;AACtC,GAAE;AACF,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,EAAE;AAC5C,GAAG,GAAG,CAAC,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,CAAC,YAAY,EAAE,EAAE,CAAC,GAAG,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;AACzE,GAAG,MAAM,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,GAAG,KAAK,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;AACvF,GAAG,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,gBAAgB,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AAC3F,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,YAAY,EAAE;AACjD,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE;AACnC,EAAE,OAAO,YAAY;AACrB,EAAE;AACF,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,KAAK,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,KAAK,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,QAAQ,EAAC;AACpF,CAAC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;AAC/B,EAAE,OAAO,YAAY;AACrB,EAAE;AACF,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAK,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,KAAK,EAAE,EAAC;AACtH,CAAC,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,GAAG,KAAK;AAClC,EAAE,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;AAClB,GAAG,OAAO,GAAG;AACb,GAAG;AACH,EAAE,MAAM,MAAM,GAAG,EAAE,IAAI,GAAG,CAAC,MAAM,IAAI,OAAO,GAAG,CAAC,MAAM,KAAK,QAAQ,GAAG,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC,GAAE;AACxF,EAAE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE;AAC3C,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE;AACnC,GAAG;AACH,EAAE,KAAK,MAAM,KAAK,IAAI,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE;AAC9C,GAAG,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,GAAE;AACpC,GAAG;AACH,EAAE,OAAO,EAAE,GAAG,GAAG,EAAE,MAAM,EAAE;AAC3B,EAAE,CAAC;AACH,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,YAAY,EAAE,MAAM,EAAE;AACzD,CAAC,MAAM,IAAI,GAAG,gBAAgB,CAAC,MAAM,EAAC;AACtC,CAAC,MAAM,QAAQ,GAAG,kBAAkB,CAAC,YAAY,EAAC;AAClD,CAAC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE;AACxB,EAAE,OAAO,QAAQ;AACjB,EAAE;AACF,CAAC,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,QAAQ,GAAG,GAAE;AACpD,CAAC,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC;AACtB,IAAI,CAAC,GAAG,GAAG,EAAE,GAAG,IAAI,CAAC;AACrB,IAAI,CAAC,EAAE,KAAK,EAAEA,SAAC,CAAC,eAAe,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,GAAG,IAAI,CAAC;AAC9E;;;;"}

package/dist/esm/utils/queryPresets.js

@@ -0,0 +1,96 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * Query presets of an index page (`config.queryPresets`): a menu entry that
+ * deep-links to a list with a query (`{ caseType: '<uuid>' }`, the shape hydra
+ * gate-68 asks for instead of a second page) can bring its own lenses,
+ * columns and copy. The page names, per preset, the query it answers to and
+ * the keys it replaces; the first preset whose every `match` pair is in the
+ * current route query wins.
+ *
+ * @module utils/queryPresets
+ * @spec openspec/changes/screens-index-query-presets/specs/index-query-presets/spec.md#requirement-a-query-preset-overlays-lenses-columns-and-copy
+ */
+
+/**
+ * The config keys a preset may replace. Anything else in a preset is ignored:
+ * a preset changes what the list shows, never which register or schema it
+ * reads or what it may write.
+ *
+ * @type {ReadonlyArray<string>}
+ */
+const QUERY_PRESET_KEYS = Object.freeze([
+	'title',
+	'quickFilters',
+	'columns',
+	'cardFields',
+	'countText',
+	'searchPlaceholder',
+	'footerNote',
+	'defaultSort',
+	'viewSwitch',
+]);
+
+/**
+ * Whether one route query value satisfies one `match` value. A repeated query
+ * parameter (an array) matches when it holds the value.
+ *
+ * @param {unknown} actual The route query value.
+ * @param {string|number|boolean} expected The preset's value.
+ * @return {boolean} True when they match.
+ */
+function queryValueMatches(actual, expected) {
+	const want = String(expected);
+	if (Array.isArray(actual)) {
+		return actual.some((v) => String(v) === want)
+	}
+	return actual !== undefined && actual !== null && String(actual) === want
+}
+
+/**
+ * The index of the first preset whose every `match` pair is in the query.
+ * A preset without a non-empty `match` never matches.
+ *
+ * @param {Array<object>} presets The page's `queryPresets`.
+ * @param {object} query The current route query.
+ * @return {number} The preset index, or -1.
+ */
+function matchQueryPreset(presets, query) {
+	if (!Array.isArray(presets)) {
+		return -1
+	}
+	const q = query && typeof query === 'object' ? query : {};
+	return presets.findIndex((preset) => {
+		const match = preset && typeof preset.match === 'object' && preset.match !== null ? preset.match : null;
+		if (!match || Object.keys(match).length === 0) {
+			return false
+		}
+		return Object.entries(match).every(([key, value]) => queryValueMatches(q[key], value))
+	})
+}
+
+/**
+ * The page config with the preset's allowed keys laid over it, and without
+ * `queryPresets` itself (the page component has no such prop).
+ *
+ * @param {object} config The page config.
+ * @param {object|null} preset The matched preset, or null.
+ * @return {object} The effective config.
+ */
+function applyQueryPreset(config, preset) {
+	const { queryPresets, ...rest } = config || {};
+	if (!preset || typeof preset !== 'object') {
+		return rest
+	}
+	const out = { ...rest };
+	for (const key of QUERY_PRESET_KEYS) {
+		if (key !== 'title' && preset[key] !== undefined) {
+			out[key] = preset[key];
+		}
+	}
+	return out
+}
+
+export { QUERY_PRESET_KEYS, applyQueryPreset, matchQueryPreset };
+//# sourceMappingURL=queryPresets.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"queryPresets.js","sources":["../../../src/utils/queryPresets.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Query presets of an index page (`config.queryPresets`): a menu entry that\n * deep-links to a list with a query (`{ caseType: '<uuid>' }`, the shape hydra\n * gate-68 asks for instead of a second page) can bring its own lenses,\n * columns and copy. The page names, per preset, the query it answers to and\n * the keys it replaces; the first preset whose every `match` pair is in the\n * current route query wins.\n *\n * @module utils/queryPresets\n * @spec openspec/changes/screens-index-query-presets/specs/index-query-presets/spec.md#requirement-a-query-preset-overlays-lenses-columns-and-copy\n */\n\n/**\n * The config keys a preset may replace. Anything else in a preset is ignored:\n * a preset changes what the list shows, never which register or schema it\n * reads or what it may write.\n *\n * @type {ReadonlyArray<string>}\n */\nexport const QUERY_PRESET_KEYS = Object.freeze([\n\t'title',\n\t'quickFilters',\n\t'columns',\n\t'cardFields',\n\t'countText',\n\t'searchPlaceholder',\n\t'footerNote',\n\t'defaultSort',\n\t'viewSwitch',\n])\n\n/**\n * Whether one route query value satisfies one `match` value. A repeated query\n * parameter (an array) matches when it holds the value.\n *\n * @param {unknown} actual The route query value.\n * @param {string|number|boolean} expected The preset's value.\n * @return {boolean} True when they match.\n */\nfunction queryValueMatches(actual, expected) {\n\tconst want = String(expected)\n\tif (Array.isArray(actual)) {\n\t\treturn actual.some((v) => String(v) === want)\n\t}\n\treturn actual !== undefined && actual !== null && String(actual) === want\n}\n\n/**\n * The index of the first preset whose every `match` pair is in the query.\n * A preset without a non-empty `match` never matches.\n *\n * @param {Array<object>} presets The page's `queryPresets`.\n * @param {object} query The current route query.\n * @return {number} The preset index, or -1.\n */\nexport function matchQueryPreset(presets, query) {\n\tif (!Array.isArray(presets)) {\n\t\treturn -1\n\t}\n\tconst q = query && typeof query === 'object' ? query : {}\n\treturn presets.findIndex((preset) => {\n\t\tconst match = preset && typeof preset.match === 'object' && preset.match !== null ? preset.match : null\n\t\tif (!match || Object.keys(match).length === 0) {\n\t\t\treturn false\n\t\t}\n\t\treturn Object.entries(match).every(([key, value]) => queryValueMatches(q[key], value))\n\t})\n}\n\n/**\n * The page config with the preset's allowed keys laid over it, and without\n * `queryPresets` itself (the page component has no such prop).\n *\n * @param {object} config The page config.\n * @param {object|null} preset The matched preset, or null.\n * @return {object} The effective config.\n */\nexport function applyQueryPreset(config, preset) {\n\tconst { queryPresets, ...rest } = config || {}\n\tif (!preset || typeof preset !== 'object') {\n\t\treturn rest\n\t}\n\tconst out = { ...rest }\n\tfor (const key of QUERY_PRESET_KEYS) {\n\t\tif (key !== 'title' && preset[key] !== undefined) {\n\t\t\tout[key] = preset[key]\n\t\t}\n\t}\n\treturn out\n}\n"],"names":[],"mappings":"AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,iBAAiB,GAAG,MAAM,CAAC,MAAM,CAAC;AAC/C,CAAC,OAAO;AACR,CAAC,cAAc;AACf,CAAC,SAAS;AACV,CAAC,YAAY;AACb,CAAC,WAAW;AACZ,CAAC,mBAAmB;AACpB,CAAC,YAAY;AACb,CAAC,aAAa;AACd,CAAC,YAAY;AACb,CAAC,EAAC;AACF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,iBAAiB,CAAC,MAAM,EAAE,QAAQ,EAAE;AAC7C,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAC;AAC9B,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE;AAC5B,EAAE,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;AAC/C,EAAE;AACF,CAAC,OAAO,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,IAAI;AAC1E,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE;AACjD,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE;AAC9B,EAAE,OAAO,CAAC,CAAC;AACX,EAAE;AACF,CAAC,MAAM,CAAC,GAAG,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,GAAG,KAAK,GAAG,GAAE;AAC1D,CAAC,OAAO,OAAO,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK;AACtC,EAAE,MAAM,KAAK,GAAG,MAAM,IAAI,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,KAAK,IAAI,GAAG,MAAM,CAAC,KAAK,GAAG,KAAI;AACzG,EAAE,IAAI,CAAC,KAAK,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,EAAE;AACjD,GAAG,OAAO,KAAK;AACf,GAAG;AACH,EAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK,iBAAiB,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;AACxF,EAAE,CAAC;AACH,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE;AACjD,CAAC,MAAM,EAAE,YAAY,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,IAAI,GAAE;AAC/C,CAAC,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,EAAE;AAC5C,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,MAAM,GAAG,GAAG,EAAE,GAAG,IAAI,GAAE;AACxB,CAAC,KAAK,MAAM,GAAG,IAAI,iBAAiB,EAAE;AACtC,EAAE,IAAI,GAAG,KAAK,OAAO,IAAI,MAAM,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE;AACpD,GAAG,GAAG,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,EAAC;AACzB,GAAG;AACH,EAAE;AACF,CAAC,OAAO,GAAG;AACX;;;;"}