@conduction/nextcloud-vue 2.66.0 → 2.68.0

package/dist/esm/utils/rowActionItem.js

@@ -0,0 +1,104 @@
+import { isLocallyDecidableVisibleWhen, evaluateVisibleWhenLocal } from './visibleWhen.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * How a row action renders as a menu entry.
+ * CnRowActions and CnContextMenu both use these, so a row's actions menu and its right-click menu agree on which entries show and on each entry's key, testid and event payload.
+ */
+
+
+/**
+ * Whether an action is a built-in row action (View, Edit, Copy, Delete).
+ *
+ * @param {object} action The action.
+ * @return {boolean} True for a built-in carrying an id.
+ */
+function isBuiltin(action) {
+	return !!action && action.builtin === true && typeof action.id === 'string' && action.id !== ''
+}
+
+/**
+ * Whether an action shows for an item.
+ * A locally decidable `visibleWhen` that is false hides it; an endpoint or source condition is not decided here.
+ * Then `visible` (a boolean or `(item) => boolean`) applies; without it the action shows.
+ *
+ * @param {object} action The action.
+ * @param {object|string|number|null} item The row or right-clicked item.
+ * @return {boolean} Whether the entry renders.
+ */
+function isRowActionVisible(action, item) {
+	if (action.visibleWhen
+		&& isLocallyDecidableVisibleWhen(action.visibleWhen)
+		&& evaluateVisibleWhenLocal(action.visibleWhen, item) === false) {
+		return false
+	}
+	if (action.visible === undefined) {
+		return true
+	}
+	if (typeof action.visible === 'function') {
+		return !!action.visible(item)
+	}
+	return !!action.visible
+}
+
+/**
+ * Slugify a label for a `data-testid` suffix: lowercase, kebab-case, non-alphanumerics stripped.
+ *
+ * @param {string} label The label.
+ * @return {string} The slug.
+ */
+function slugifyActionLabel(label) {
+	// One pass collapses every run of other characters to a single '-', so at
+	// most one '-' can sit at either end; trimming it by index keeps this
+	// linear. `/^-+|-+$/g` here was a ReDoS on long runs of '-' (CodeQL).
+	const slug = String(label || '')
+		.toLowerCase()
+		.replace(/[^a-z0-9]+/g, '-');
+	const start = slug.startsWith('-') ? 1 : 0;
+	const end = slug.length > start && slug.endsWith('-') ? slug.length - 1 : slug.length;
+	return slug.slice(start, end)
+}
+
+/**
+ * The render key of an entry: `builtin:<id>` for a built-in, the label for an app action.
+ * An app action with `id: "edit"` therefore never shares a key with the built-in Edit.
+ *
+ * @param {object} action The action.
+ * @return {string} The key.
+ */
+function rowActionKey(action) {
+	return isBuiltin(action) ? `builtin:${action.id}` : action.label
+}
+
+/**
+ * The `data-testid` of an entry: `cn-action-item-<id>` for a built-in, in every locale, and the slug of the label for an app action.
+ *
+ * @param {object} action The action.
+ * @return {string} The testid.
+ */
+function rowActionTestId(action) {
+	return `cn-action-item-${isBuiltin(action) ? action.id : slugifyActionLabel(action.label)}`
+}
+
+/**
+ * The `action` event payload for an entry: `action` is the label, `id` is the action's id when it has one, and `builtin: true` marks a built-in.
+ *
+ * @param {object} action The action.
+ * @param {object|string|number|null} row The row or right-clicked item.
+ * @return {{action: string, row: (object|string|number|null), id?: string, builtin?: true}} The payload.
+ */
+function rowActionPayload(action, row) {
+	const payload = { action: action.label, row };
+	if (typeof action.id === 'string' && action.id !== '') {
+		payload.id = action.id;
+	}
+	if (isBuiltin(action)) {
+		payload.builtin = true;
+	}
+	return payload
+}
+
+export { isRowActionVisible, rowActionKey, rowActionPayload, rowActionTestId, slugifyActionLabel };
+//# sourceMappingURL=rowActionItem.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"rowActionItem.js","sources":["../../../src/utils/rowActionItem.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>\n * SPDX-License-Identifier: EUPL-1.2\n *\n * How a row action renders as a menu entry.\n * CnRowActions and CnContextMenu both use these, so a row's actions menu and its right-click menu agree on which entries show and on each entry's key, testid and event payload.\n */\n\nimport { evaluateVisibleWhenLocal, isLocallyDecidableVisibleWhen } from './visibleWhen.js'\n\n/**\n * Whether an action is a built-in row action (View, Edit, Copy, Delete).\n *\n * @param {object} action The action.\n * @return {boolean} True for a built-in carrying an id.\n */\nfunction isBuiltin(action) {\n\treturn !!action && action.builtin === true && typeof action.id === 'string' && action.id !== ''\n}\n\n/**\n * Whether an action shows for an item.\n * A locally decidable `visibleWhen` that is false hides it; an endpoint or source condition is not decided here.\n * Then `visible` (a boolean or `(item) => boolean`) applies; without it the action shows.\n *\n * @param {object} action The action.\n * @param {object|string|number|null} item The row or right-clicked item.\n * @return {boolean} Whether the entry renders.\n */\nexport function isRowActionVisible(action, item) {\n\tif (action.visibleWhen\n\t\t&& isLocallyDecidableVisibleWhen(action.visibleWhen)\n\t\t&& evaluateVisibleWhenLocal(action.visibleWhen, item) === false) {\n\t\treturn false\n\t}\n\tif (action.visible === undefined) {\n\t\treturn true\n\t}\n\tif (typeof action.visible === 'function') {\n\t\treturn !!action.visible(item)\n\t}\n\treturn !!action.visible\n}\n\n/**\n * Slugify a label for a `data-testid` suffix: lowercase, kebab-case, non-alphanumerics stripped.\n *\n * @param {string} label The label.\n * @return {string} The slug.\n */\nexport function slugifyActionLabel(label) {\n\t// One pass collapses every run of other characters to a single '-', so at\n\t// most one '-' can sit at either end; trimming it by index keeps this\n\t// linear. `/^-+|-+$/g` here was a ReDoS on long runs of '-' (CodeQL).\n\tconst slug = String(label || '')\n\t\t.toLowerCase()\n\t\t.replace(/[^a-z0-9]+/g, '-')\n\tconst start = slug.startsWith('-') ? 1 : 0\n\tconst end = slug.length > start && slug.endsWith('-') ? slug.length - 1 : slug.length\n\treturn slug.slice(start, end)\n}\n\n/**\n * The render key of an entry: `builtin:<id>` for a built-in, the label for an app action.\n * An app action with `id: \"edit\"` therefore never shares a key with the built-in Edit.\n *\n * @param {object} action The action.\n * @return {string} The key.\n */\nexport function rowActionKey(action) {\n\treturn isBuiltin(action) ? `builtin:${action.id}` : action.label\n}\n\n/**\n * The `data-testid` of an entry: `cn-action-item-<id>` for a built-in, in every locale, and the slug of the label for an app action.\n *\n * @param {object} action The action.\n * @return {string} The testid.\n */\nexport function rowActionTestId(action) {\n\treturn `cn-action-item-${isBuiltin(action) ? action.id : slugifyActionLabel(action.label)}`\n}\n\n/**\n * The `action` event payload for an entry: `action` is the label, `id` is the action's id when it has one, and `builtin: true` marks a built-in.\n *\n * @param {object} action The action.\n * @param {object|string|number|null} row The row or right-clicked item.\n * @return {{action: string, row: (object|string|number|null), id?: string, builtin?: true}} The payload.\n */\nexport function rowActionPayload(action, row) {\n\tconst payload = { action: action.label, row }\n\tif (typeof action.id === 'string' && action.id !== '') {\n\t\tpayload.id = action.id\n\t}\n\tif (isBuiltin(action)) {\n\t\tpayload.builtin = true\n\t}\n\treturn payload\n}\n"],"names":[],"mappings":";;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,SAAS,CAAC,MAAM,EAAE;AAC3B,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,MAAM,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE;AAChG,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,MAAM,EAAE,IAAI,EAAE;AACjD,CAAC,IAAI,MAAM,CAAC,WAAW;AACvB,KAAK,6BAA6B,CAAC,MAAM,CAAC,WAAW,CAAC;AACtD,KAAK,wBAAwB,CAAC,MAAM,CAAC,WAAW,EAAE,IAAI,CAAC,KAAK,KAAK,EAAE;AACnE,EAAE,OAAO,KAAK;AACd,EAAE;AACF,CAAC,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE;AACnC,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,IAAI,OAAO,MAAM,CAAC,OAAO,KAAK,UAAU,EAAE;AAC3C,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC;AAC/B,EAAE;AACF,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO;AACxB,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,KAAK,EAAE;AAC1C;AACA;AACA;AACA,CAAC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;AACjC,GAAG,WAAW,EAAE;AAChB,GAAG,OAAO,CAAC,aAAa,EAAE,GAAG,EAAC;AAC9B,CAAC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,EAAC;AAC3C,CAAC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,OAAM;AACtF,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC;AAC9B,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,YAAY,CAAC,MAAM,EAAE;AACrC,CAAC,OAAO,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,KAAK;AACjE,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,eAAe,CAAC,MAAM,EAAE;AACxC,CAAC,OAAO,CAAC,eAAe,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,EAAE,GAAG,kBAAkB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;AAC5F,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE;AAC9C,CAAC,MAAM,OAAO,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE,GAAG,GAAE;AAC9C,CAAC,IAAI,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,EAAE,KAAK,EAAE,EAAE;AACxD,EAAE,OAAO,CAAC,EAAE,GAAG,MAAM,CAAC,GAAE;AACxB,EAAE;AACF,CAAC,IAAI,SAAS,CAAC,MAAM,CAAC,EAAE;AACxB,EAAE,OAAO,CAAC,OAAO,GAAG,KAAI;AACxB,EAAE;AACF,CAAC,OAAO,OAAO;AACf;;;;"}

package/dist/esm/utils/timelineEvents.js

@@ -97,6 +97,49 @@ function fieldEvents(object, fields, now = new Date()) {
  * @param {Date} [now] The reference moment.
  * @return {Array<object>} The events.
  */
+/**
+ * The text at a path of a list entry, or '' when the path is unset or empty.
+ *
+ * @param {object} row The list entry.
+ * @param {string|undefined} path The path to read.
+ * @return {string} The text.
+ */
+function textAt(row, path) {
+	if (!path) {
+		return ''
+	}
+	const value = readPath(row, path);
+	return value === null || value === undefined ? '' : String(value)
+}
+
+/**
+ * Events from a list held on the object itself, such as a status history:
+ * `[{ field, dateField, labelField?, label?, detailField? }]`. Each entry of the
+ * list at `field` becomes one event, dated by `dateField`, labelled by its
+ * `labelField` value (else `label`), with `detailField` as the line under it.
+ *
+ * @param {object} object The object.
+ * @param {Array<object>} lists The list configs.
+ * @param {Date} now The moment that separates past from upcoming.
+ * @return {Array<object>} The events.
+ * @spec openspec/changes/timeline-audit-trails-url/specs/timeline-widget/spec.md#requirement-a-list-on-the-object-becomes-dated-events
+ */
+function listEvents(object, lists, now = new Date()) {
+	return (Array.isArray(lists) ? lists : [])
+		.filter((l) => l && typeof l.field === 'string' && typeof l.dateField === 'string')
+		.flatMap((l) => {
+			const rows = readPath(object, l.field);
+			return (Array.isArray(rows) ? rows : []).map((row, i) => makeEvent({
+				id: `list:${l.field}:${i}`,
+				raw: readPath(row, l.dateField),
+				label: textAt(row, l.labelField) || l.label || l.field,
+				detail: textAt(row, l.detailField),
+				source: 'list',
+			}, now))
+		})
+		.filter(Boolean)
+}
+
 function relatedEvents(rows, config, now = new Date()) {
 	const cfg = config || {};
 	const dateField = cfg.dateField || '@self.created';
@@ -170,5 +213,5 @@ function sortEvents(events, order = 'asc') {
 		.map(({ e }) => e)
 }
 
-export { auditEvents, fieldEvents, parseMoment, readPath, relatedEvents, sortEvents, timelineEntryEvents };
+export { auditEvents, fieldEvents, listEvents, parseMoment, readPath, relatedEvents, sortEvents, timelineEntryEvents };
 //# sourceMappingURL=timelineEvents.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"timelineEvents.js","sources":["../../../src/utils/timelineEvents.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\n/**\n * Turn an object's dated facts into timeline events.\n *\n * Pure helpers behind `CnTimelineWidget`. An event is\n * `{ id, at, dateOnly, label, detail, source, upcoming }`, where `at` is a\n * `Date`, `dateOnly` says the source value carried no time of day, and\n * `upcoming` says the moment lies after `now`.\n *\n * @module utils/timelineEvents\n * @spec openspec/changes/timeline-widget/specs/timeline-widget/spec.md\n */\n\n/**\n * Read a dotted path off an object (`@self.created`, `payment.clearedAt`).\n *\n * @param {object} obj The object.\n * @param {string} path The dotted path.\n * @return {unknown} The value, or undefined.\n */\nexport function readPath(obj, path) {\n\tif (!obj || typeof path !== 'string' || path === '') {\n\t\treturn undefined\n\t}\n\tif (Object.hasOwn(obj, path)) {\n\t\treturn obj[path]\n\t}\n\treturn path.split('.').reduce((acc, part) => ((acc === null || acc === undefined) ? undefined : acc[part]), obj)\n}\n\n/**\n * Parse a stored date value. A bare `YYYY-MM-DD` is a calendar day and is\n * read as local midnight, not UTC, so it never shows as the day before.\n *\n * @param {unknown} raw The stored value.\n * @return {{at: Date, dateOnly: boolean}|null} The moment, or null when it is not a date.\n */\nexport function parseMoment(raw) {\n\tif (raw === undefined || raw === null || raw === '') {\n\t\treturn null\n\t}\n\tif (typeof raw === 'string' && /^\\d{4}-\\d{2}-\\d{2}$/.test(raw)) {\n\t\tconst [y, m, d] = raw.split('-').map(Number)\n\t\treturn { at: new Date(y, m - 1, d), dateOnly: true }\n\t}\n\tconst at = new Date(raw)\n\treturn Number.isNaN(at.getTime()) ? null : { at, dateOnly: false }\n}\n\n/**\n * Build one event, or null when the value is not a date.\n *\n * @param {object} spec `{ id, raw, label, detail, source }`.\n * @param {Date} now The reference moment for `upcoming`.\n * @return {object|null} The event.\n */\nfunction makeEvent(spec, now) {\n\tconst moment = parseMoment(spec.raw)\n\tif (!moment) {\n\t\treturn null\n\t}\n\treturn {\n\t\tid: spec.id,\n\t\tat: moment.at,\n\t\tdateOnly: moment.dateOnly,\n\t\tlabel: spec.label || '',\n\t\tdetail: spec.detail || '',\n\t\tsource: spec.source,\n\t\tupcoming: moment.at.getTime() > now.getTime(),\n\t}\n}\n\n/**\n * Events from the object's own date properties.\n *\n * @param {object} object The object.\n * @param {Array<{field: string, label?: string}>} fields The configured date fields.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} One event per field that holds a date.\n */\nexport function fieldEvents(object, fields, now = new Date()) {\n\treturn (Array.isArray(fields) ? fields : [])\n\t\t.filter((f) => f && typeof f.field === 'string')\n\t\t.map((f) => makeEvent({ id: `field:${f.field}`, raw: readPath(object, f.field), label: f.label || f.field, source: 'field' }, now))\n\t\t.filter(Boolean)\n}\n\n/**\n * Events from related objects: one per row that holds a date in `dateField`.\n *\n * @param {Array<object>} rows The related objects.\n * @param {{label?: string, dateField?: string, titleField?: string, schema?: string}} config The related-source config.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} The events.\n */\nexport function relatedEvents(rows, config, now = new Date()) {\n\tconst cfg = config || {}\n\tconst dateField = cfg.dateField || '@self.created'\n\treturn (Array.isArray(rows) ? rows : [])\n\t\t.map((row, i) => {\n\t\t\tconst self = (row && row['@self']) || {}\n\t\t\tconst id = String(self.id || row.id || i)\n\t\t\tconst title = cfg.titleField ? readPath(row, cfg.titleField) : (row && (row.title || row.name)) || self.name\n\t\t\treturn makeEvent({\n\t\t\t\tid: `related:${cfg.schema || ''}:${id}`,\n\t\t\t\traw: readPath(row, dateField),\n\t\t\t\tlabel: cfg.label || '',\n\t\t\t\tdetail: title === undefined || title === null ? '' : String(title),\n\t\t\t\tsource: 'related',\n\t\t\t}, now)\n\t\t})\n\t\t.filter(Boolean)\n}\n\n/**\n * Events from audit-trail entries.\n *\n * @param {Array<object>} entries The audit-trail rows.\n * @param {(action: string, actor: string) => string} describe Builds the label from action and actor.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} The events.\n */\nexport function auditEvents(entries, describe, now = new Date()) {\n\treturn (Array.isArray(entries) ? entries : [])\n\t\t.map((e, i) => makeEvent({\n\t\t\tid: `audit:${e && (e.id || e.uuid) ? (e.id || e.uuid) : i}`,\n\t\t\traw: e && (e.created || e.creationDateTime || e.timestamp),\n\t\t\tlabel: describe(String((e && (e.action || e.event)) || ''), String((e && (e.actorDisplayName || e.userName || e.user || e.actor)) || '')),\n\t\t\tsource: 'audit',\n\t\t}, now))\n\t\t.filter(Boolean)\n}\n\n/**\n * Events from OpenRegister's timeline (notes, calls, messages).\n *\n * @param {Array<object>} entries The timeline rows.\n * @param {string} noteLabel The label for an entry without a kind.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} The events.\n */\nexport function timelineEntryEvents(entries, noteLabel, now = new Date()) {\n\treturn (Array.isArray(entries) ? entries : [])\n\t\t.map((e, i) => makeEvent({\n\t\t\tid: `timeline:${e && e.id ? e.id : i}`,\n\t\t\traw: e && e.created,\n\t\t\tlabel: (e && (e.kindTitle || e.kind)) || noteLabel,\n\t\t\tdetail: [e && e.author, e && e.message].filter(Boolean).join(': '),\n\t\t\tsource: 'timeline',\n\t\t}, now))\n\t\t.filter(Boolean)\n}\n\n/**\n * Sort events by time; ties keep their input order.\n *\n * @param {Array<object>} events The events.\n * @param {'asc'|'desc'} [order] Oldest first (default) or newest first.\n * @return {Array<object>} A new, sorted array.\n */\nexport function sortEvents(events, order = 'asc') {\n\tconst dir = order === 'desc' ? -1 : 1\n\treturn (events || [])\n\t\t.map((e, i) => ({ e, i }))\n\t\t.sort((a, b) => ((a.e.at.getTime() - b.e.at.getTime()) * dir) || (a.i - b.i))\n\t\t.map(({ e }) => e)\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;AACO,SAAS,QAAQ,CAAC,GAAG,EAAE,IAAI,EAAE;AACpC,CAAC,IAAI,CAAC,GAAG,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,EAAE,EAAE;AACtD,EAAE,OAAO,SAAS;AAClB,EAAE;AACF,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE;AAC/B,EAAE,OAAO,GAAG,CAAC,IAAI,CAAC;AAClB,EAAE;AACF,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,MAAM,CAAC,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,SAAS,IAAI,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC;AACjH,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,WAAW,CAAC,GAAG,EAAE;AACjC,CAAC,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,EAAE,EAAE;AACtD,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,qBAAqB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE;AACjE,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,EAAC;AAC9C,EAAE,OAAO,EAAE,EAAE,EAAE,IAAI,IAAI,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE;AACtD,EAAE;AACF,CAAC,MAAM,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAC;AACzB,CAAC,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,EAAE,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE;AACnE,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAAS,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE;AAC9B,CAAC,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,CAAC,GAAG,EAAC;AACrC,CAAC,IAAI,CAAC,MAAM,EAAE;AACd,EAAE,OAAO,IAAI;AACb,EAAE;AACF,CAAC,OAAO;AACR,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE;AACb,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE;AACf,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ;AAC3B,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,EAAE;AACzB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,EAAE;AAC3B,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM;AACrB,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,GAAG,CAAC,OAAO,EAAE;AAC/C,EAAE;AACF,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE;AAC9D,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GAAG,EAAE;AAC5C,GAAG,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAAC;AAClD,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,EAAE,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,GAAG,CAAC,CAAC;AACrI,GAAG,MAAM,CAAC,OAAO,CAAC;AAClB,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE;AAC9D,CAAC,MAAM,GAAG,GAAG,MAAM,IAAI,GAAE;AACzB,CAAC,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,gBAAe;AACnD,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,EAAE;AACxC,GAAG,GAAG,CAAC,CAAC,GAAG,EAAE,CAAC,KAAK;AACnB,GAAG,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,KAAK,GAAE;AAC3C,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,EAAE,IAAI,GAAG,CAAC,EAAE,IAAI,CAAC,EAAC;AAC5C,GAAG,MAAM,KAAK,GAAG,GAAG,CAAC,UAAU,GAAG,QAAQ,CAAC,GAAG,EAAE,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,KAAK,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAI;AAC/G,GAAG,OAAO,SAAS,CAAC;AACpB,IAAI,EAAE,EAAE,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AAC3C,IAAI,GAAG,EAAE,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC;AACjC,IAAI,KAAK,EAAE,GAAG,CAAC,KAAK,IAAI,EAAE;AAC1B,IAAI,MAAM,EAAE,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI,GAAG,EAAE,GAAG,MAAM,CAAC,KAAK,CAAC;AACtE,IAAI,MAAM,EAAE,SAAS;AACrB,IAAI,EAAE,GAAG,CAAC;AACV,GAAG,CAAC;AACJ,GAAG,MAAM,CAAC,OAAO,CAAC;AAClB,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,WAAW,CAAC,OAAO,EAAE,QAAQ,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE;AACjE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,EAAE;AAC9C,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;AAC3B,GAAG,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC;AAC9D,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,SAAS,CAAC;AAC7D,GAAG,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC;AAC5I,GAAG,MAAM,EAAE,OAAO;AAClB,GAAG,EAAE,GAAG,CAAC,CAAC;AACV,GAAG,MAAM,CAAC,OAAO,CAAC;AAClB,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,mBAAmB,CAAC,OAAO,EAAE,SAAS,EAAE,GAAG,GAAG,IAAI,IAAI,EAAE,EAAE;AAC1E,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO,GAAG,EAAE;AAC9C,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,SAAS,CAAC;AAC3B,GAAG,EAAE,EAAE,CAAC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;AACzC,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO;AACtB,GAAG,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,SAAS;AACrD,GAAG,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;AACrE,GAAG,MAAM,EAAE,UAAU;AACrB,GAAG,EAAE,GAAG,CAAC,CAAC;AACV,GAAG,MAAM,CAAC,OAAO,CAAC;AAClB,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,UAAU,CAAC,MAAM,EAAE,KAAK,GAAG,KAAK,EAAE;AAClD,CAAC,MAAM,GAAG,GAAG,KAAK,KAAK,MAAM,GAAG,CAAC,CAAC,GAAG,EAAC;AACtC,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE;AACrB,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;AAC5B,GAAG,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/E,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,CAAC,CAAC;AACpB;;;;"}
+{"version":3,"file":"timelineEvents.js","sources":["../../../src/utils/timelineEvents.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\n/**\n * Turn an object's dated facts into timeline events.\n *\n * Pure helpers behind `CnTimelineWidget`. An event is\n * `{ id, at, dateOnly, label, detail, source, upcoming }`, where `at` is a\n * `Date`, `dateOnly` says the source value carried no time of day, and\n * `upcoming` says the moment lies after `now`.\n *\n * @module utils/timelineEvents\n * @spec openspec/changes/timeline-widget/specs/timeline-widget/spec.md\n */\n\n/**\n * Read a dotted path off an object (`@self.created`, `payment.clearedAt`).\n *\n * @param {object} obj The object.\n * @param {string} path The dotted path.\n * @return {unknown} The value, or undefined.\n */\nexport function readPath(obj, path) {\n\tif (!obj || typeof path !== 'string' || path === '') {\n\t\treturn undefined\n\t}\n\tif (Object.hasOwn(obj, path)) {\n\t\treturn obj[path]\n\t}\n\treturn path.split('.').reduce((acc, part) => ((acc === null || acc === undefined) ? undefined : acc[part]), obj)\n}\n\n/**\n * Parse a stored date value. A bare `YYYY-MM-DD` is a calendar day and is\n * read as local midnight, not UTC, so it never shows as the day before.\n *\n * @param {unknown} raw The stored value.\n * @return {{at: Date, dateOnly: boolean}|null} The moment, or null when it is not a date.\n */\nexport function parseMoment(raw) {\n\tif (raw === undefined || raw === null || raw === '') {\n\t\treturn null\n\t}\n\tif (typeof raw === 'string' && /^\\d{4}-\\d{2}-\\d{2}$/.test(raw)) {\n\t\tconst [y, m, d] = raw.split('-').map(Number)\n\t\treturn { at: new Date(y, m - 1, d), dateOnly: true }\n\t}\n\tconst at = new Date(raw)\n\treturn Number.isNaN(at.getTime()) ? null : { at, dateOnly: false }\n}\n\n/**\n * Build one event, or null when the value is not a date.\n *\n * @param {object} spec `{ id, raw, label, detail, source }`.\n * @param {Date} now The reference moment for `upcoming`.\n * @return {object|null} The event.\n */\nfunction makeEvent(spec, now) {\n\tconst moment = parseMoment(spec.raw)\n\tif (!moment) {\n\t\treturn null\n\t}\n\treturn {\n\t\tid: spec.id,\n\t\tat: moment.at,\n\t\tdateOnly: moment.dateOnly,\n\t\tlabel: spec.label || '',\n\t\tdetail: spec.detail || '',\n\t\tsource: spec.source,\n\t\tupcoming: moment.at.getTime() > now.getTime(),\n\t}\n}\n\n/**\n * Events from the object's own date properties.\n *\n * @param {object} object The object.\n * @param {Array<{field: string, label?: string}>} fields The configured date fields.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} One event per field that holds a date.\n */\nexport function fieldEvents(object, fields, now = new Date()) {\n\treturn (Array.isArray(fields) ? fields : [])\n\t\t.filter((f) => f && typeof f.field === 'string')\n\t\t.map((f) => makeEvent({ id: `field:${f.field}`, raw: readPath(object, f.field), label: f.label || f.field, source: 'field' }, now))\n\t\t.filter(Boolean)\n}\n\n/**\n * Events from related objects: one per row that holds a date in `dateField`.\n *\n * @param {Array<object>} rows The related objects.\n * @param {{label?: string, dateField?: string, titleField?: string, schema?: string}} config The related-source config.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} The events.\n */\n/**\n * The text at a path of a list entry, or '' when the path is unset or empty.\n *\n * @param {object} row The list entry.\n * @param {string|undefined} path The path to read.\n * @return {string} The text.\n */\nfunction textAt(row, path) {\n\tif (!path) {\n\t\treturn ''\n\t}\n\tconst value = readPath(row, path)\n\treturn value === null || value === undefined ? '' : String(value)\n}\n\n/**\n * Events from a list held on the object itself, such as a status history:\n * `[{ field, dateField, labelField?, label?, detailField? }]`. Each entry of the\n * list at `field` becomes one event, dated by `dateField`, labelled by its\n * `labelField` value (else `label`), with `detailField` as the line under it.\n *\n * @param {object} object The object.\n * @param {Array<object>} lists The list configs.\n * @param {Date} now The moment that separates past from upcoming.\n * @return {Array<object>} The events.\n * @spec openspec/changes/timeline-audit-trails-url/specs/timeline-widget/spec.md#requirement-a-list-on-the-object-becomes-dated-events\n */\nexport function listEvents(object, lists, now = new Date()) {\n\treturn (Array.isArray(lists) ? lists : [])\n\t\t.filter((l) => l && typeof l.field === 'string' && typeof l.dateField === 'string')\n\t\t.flatMap((l) => {\n\t\t\tconst rows = readPath(object, l.field)\n\t\t\treturn (Array.isArray(rows) ? rows : []).map((row, i) => makeEvent({\n\t\t\t\tid: `list:${l.field}:${i}`,\n\t\t\t\traw: readPath(row, l.dateField),\n\t\t\t\tlabel: textAt(row, l.labelField) || l.label || l.field,\n\t\t\t\tdetail: textAt(row, l.detailField),\n\t\t\t\tsource: 'list',\n\t\t\t}, now))\n\t\t})\n\t\t.filter(Boolean)\n}\n\nexport function relatedEvents(rows, config, now = new Date()) {\n\tconst cfg = config || {}\n\tconst dateField = cfg.dateField || '@self.created'\n\treturn (Array.isArray(rows) ? rows : [])\n\t\t.map((row, i) => {\n\t\t\tconst self = (row && row['@self']) || {}\n\t\t\tconst id = String(self.id || row.id || i)\n\t\t\tconst title = cfg.titleField ? readPath(row, cfg.titleField) : (row && (row.title || row.name)) || self.name\n\t\t\treturn makeEvent({\n\t\t\t\tid: `related:${cfg.schema || ''}:${id}`,\n\t\t\t\traw: readPath(row, dateField),\n\t\t\t\tlabel: cfg.label || '',\n\t\t\t\tdetail: title === undefined || title === null ? '' : String(title),\n\t\t\t\tsource: 'related',\n\t\t\t}, now)\n\t\t})\n\t\t.filter(Boolean)\n}\n\n/**\n * Events from audit-trail entries.\n *\n * @param {Array<object>} entries The audit-trail rows.\n * @param {(action: string, actor: string) => string} describe Builds the label from action and actor.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} The events.\n */\nexport function auditEvents(entries, describe, now = new Date()) {\n\treturn (Array.isArray(entries) ? entries : [])\n\t\t.map((e, i) => makeEvent({\n\t\t\tid: `audit:${e && (e.id || e.uuid) ? (e.id || e.uuid) : i}`,\n\t\t\traw: e && (e.created || e.creationDateTime || e.timestamp),\n\t\t\tlabel: describe(String((e && (e.action || e.event)) || ''), String((e && (e.actorDisplayName || e.userName || e.user || e.actor)) || '')),\n\t\t\tsource: 'audit',\n\t\t}, now))\n\t\t.filter(Boolean)\n}\n\n/**\n * Events from OpenRegister's timeline (notes, calls, messages).\n *\n * @param {Array<object>} entries The timeline rows.\n * @param {string} noteLabel The label for an entry without a kind.\n * @param {Date} [now] The reference moment.\n * @return {Array<object>} The events.\n */\nexport function timelineEntryEvents(entries, noteLabel, now = new Date()) {\n\treturn (Array.isArray(entries) ? entries : [])\n\t\t.map((e, i) => makeEvent({\n\t\t\tid: `timeline:${e && e.id ? e.id : i}`,\n\t\t\traw: e && e.created,\n\t\t\tlabel: (e && (e.kindTitle || e.kind)) || noteLabel,\n\t\t\tdetail: [e && e.author, e && e.message].filter(Boolean).join(': '),\n\t\t\tsource: 'timeline',\n\t\t}, now))\n\t\t.filter(Boolean)\n}\n\n/**\n * Sort events by time; ties keep their input order.\n *\n * @param {Array<object>} events The events.\n * @param {'asc'|'desc'} [order] Oldest first (default) or newest first.\n * @return {Array<object>} A new, sorted array.\n */\nexport function sortEvents(events, order = 'asc') {\n\tconst dir = order === 'desc' ? -1 : 1\n\treturn (events || [])\n\t\t.map((e, i) => ({ e, i }))\n\t\t.sort((a, b) => ((a.e.at.getTime() - b.e.at.getTime()) * dir) || (a.i - b.i))\n\t\t.map(({ e }) => e)\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/validateManifest.js

@@ -1,5 +1,6 @@
 import { BUILT_IN_FILE_COLUMNS } from '../components/CnFilesBrowser/filesBrowserColumns.js';
 import { LIBRARY_WIDGET_KEYS } from './libraryWidgetKeys.js';
+import { resolveRowActions } from './resolveRowActions.js';
 import { resolveSlotColumns } from './resolveSlotColumns.js';
 import _compiledValidateV2 from './validateManifestV2.compiled.js';
 
@@ -111,9 +112,14 @@ const CHART_VALUE_AXIS_BASELINES = ['auto', 'zero', 'fit'];
  *    page's own `config.columns` does not declare (the page declares which
  *    columns it has; a scope only chooses among them)
  *
+ * It also returns non-fatal `warnings`, which never affect `valid` (index pages with an `entitySource` are skipped):
+ *  - A `"builtin:<id>"` placeholder whose built-in the manifest's toggles turn off
+ *  - The built-in Delete enabled but not the last entry of the rendered row action order
+ *
  * @spec openspec/changes/manifest-v2-schema/specs/manifest-v2-schema/spec.md
+ * @spec openspec/changes/row-action-builtin-placement/specs/index-page/spec.md
  * @param {object} manifest The v2 manifest object to validate.
- * @return {{ valid: boolean, errors: string[] }}
+ * @return {{ valid: boolean, errors: string[], warnings: string[] }}
  */
 function validateManifestV2(manifest) {
 	// Clone so Ajv useDefaults mutations don't affect the caller's copy.
@@ -780,7 +786,57 @@ function validateManifestV2(manifest) {
 		});
 	}
 
-	return { valid: errors.length === 0, errors }
+	// --- Post-schema warnings (never affect `valid`) ---
+	const warnings = [];
+
+	// W1. Row action placement on an index page: a placeholder whose built-in the manifest turns off, and the built-in Delete placed before other row actions.
+	//     An entitySource page is skipped: its built-in defaults depend on the source at runtime.
+	if (Array.isArray(clone.pages)) {
+		clone.pages.forEach((page, pIndex) => {
+			const config = page && page.type === 'index' && isPlainObject(page.config) ? page.config : null;
+			if (!config || !Array.isArray(config.actions) || typeof config.entitySource === 'string') {
+				return
+			}
+			const resolved = resolveRowActions(config.actions, indexPageBuiltinStubs(config));
+			for (const warning of resolved.warnings) {
+				if (warning.code === 'disabled-placeholder') {
+					warnings.push(`pages[${pIndex}]/config/actions: ${warning.message}`);
+				}
+			}
+			if (resolved.deleteNotLast) {
+				warnings.push(`pages[${pIndex}]/config/actions: "builtin:delete" is not the last row action in the rendered order (enabled built-ins the array does not place are appended after it); Delete is normally last`);
+			}
+		});
+	}
+
+	return { valid: errors.length === 0, errors, warnings }
+}
+
+/**
+ * The built-in row actions an index page enables, as `{ id, builtin, label }` stubs in default order.
+ * They are read from its config the way CnPageRenderer derives the show*Action props: an explicit `config.show*Action` wins over `config.actionToggles`, and `config.readOnly: true` turns Edit, Copy and Delete off by default.
+ * A non-boolean value counts as the default.
+ *
+ * @param {object} config The page's config.
+ * @return {Array<{id: string, builtin: true, label: string}>} The enabled built-ins.
+ */
+function indexPageBuiltinStubs(config) {
+	const toggles = isPlainObject(config.actionToggles) ? config.actionToggles : {};
+	const flag = (key, readOnlyOff) => {
+		if (typeof config[key] === 'boolean') {
+			return config[key]
+		}
+		if (typeof toggles[key] === 'boolean') {
+			return toggles[key]
+		}
+		return !(readOnlyOff && config.readOnly === true)
+	};
+	return [
+		['view', flag('showViewAction', false)],
+		['edit', flag('showEditAction', true)],
+		['copy', flag('showCopyAction', true)],
+		['delete', flag('showDeleteAction', true)],
+	].filter(([, on]) => on).map(([id]) => ({ id, builtin: true, label: id }))
 }
 
 /**
@@ -844,7 +900,7 @@ function isSentinel(value) {
  *   `pageTypes` registry is known up-front. When omitted, any
  *   non-empty string is accepted; the runtime renderer logs a warning
  *   for unknown types.
- * @return {{ valid: boolean, errors: string[] }}
+ * @return {{ valid: boolean, errors: string[], warnings?: string[] }} A v2 manifest also gets `warnings`, which never affect `valid`.
  */
 function validateManifest(manifest, options = {}) {
 	// Dispatch to v2 validator when the manifest declares a v2 $schema.