@conduction/nextcloud-vue 2.119.0 → 2.121.0

package/dist/esm/utils/aiFeatures.js

@@ -0,0 +1,245 @@
+import axios__default from '@nextcloud/axios';
+import { translate } from '@nextcloud/l10n';
+import { prefixUrl } from './headers.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The reads and the run behind CnAiFeaturesWidget: the AI features a record's
+ * TYPE object places on a surface, where hermiq runs each one, a run on one of
+ * the record's documents, and the sentence a refusal is shown as.
+ *
+ * An undeclared type asks nobody: the declaration is read first and the
+ * features endpoint is called only when something is placed on the surface.
+ * Every read answers null when it failed, so the widget can say it is
+ * incomplete instead of drawing an empty list.
+ *
+ * The run goes to hermiq in the reader's own session, so their own access
+ * decides which document can be read. A request without a usable document
+ * reference is refused before it is sent: hermiq's redaction gate sits on the
+ * document, and a request without one would run unchecked.
+ */
+
+/** The gate name for a run refused before it was sent. */
+const MISSING_REFERENCE = 'missing-reference';
+
+/** The hermiq endpoint a feature runs on a document through; `{slug}` is filled in. */
+const DEFAULT_RUN_ENDPOINT = '/apps/hermiq/api/ai-features/{slug}/run-on-document';
+
+/**
+ * A run that was refused, before sending or by one of hermiq's gates.
+ */
+class AiFeatureRefusal extends Error {
+	/**
+	 * @param {string}      feature The feature slug.
+	 * @param {string}      reason  The refusing side's own sentence.
+	 * @param {string|null} gate    The gate that refused, when named.
+	 */
+	constructor(feature, reason, gate) {
+		super(reason);
+		this.name = 'AiFeatureRefusal';
+		this.feature = feature;
+		this.reason = reason;
+		this.gate = gate;
+	}
+}
+
+/**
+ * The id inside a reference that may be a plain id or an object carrying one.
+ *
+ * @param {string|object|null|undefined} value The reference.
+ * @return {string} The id, or ''.
+ */
+function referenceId(value) {
+	if (value !== null && typeof value === 'object') {
+		return String(value.id ?? value.uuid ?? '').trim()
+	}
+	return String(value ?? '').trim()
+}
+
+/**
+ * The slugs a type object places on one surface. The declaration is a map of
+ * feature slug to surface name.
+ *
+ * @param {object} typeObject The type object.
+ * @param {string} field      The declaration field.
+ * @param {string} surface    The surface.
+ * @return {Array<string>} The slugs, in declaration order.
+ */
+function surfaceSlugs(typeObject, field, surface) {
+	const declared = typeObject?.[field];
+	if (declared === null || typeof declared !== 'object' || Array.isArray(declared)) {
+		return []
+	}
+	return Object.keys(declared).filter((slug) => declared[slug] === surface)
+}
+
+/**
+ * Read one OpenRegister object.
+ *
+ * @param {string} apiBase  API root.
+ * @param {string} register Register.
+ * @param {string} schema   Schema.
+ * @param {string} id       Object id.
+ * @return {Promise<object>} The object.
+ */
+async function readObject(apiBase, register, schema, id) {
+	const { data } = await axios__default.get(prefixUrl(`${apiBase}/objects/${register}/${schema}/${encodeURIComponent(id)}`));
+	return data?.object ?? data ?? {}
+}
+
+/**
+ * The AI features the record's type places on the surface, each with where it
+ * runs as the features endpoint answers it.
+ *
+ * @param {object} options                         The options.
+ * @param {string} options.apiBase                 OpenRegister API root.
+ * @param {string} options.register                Register.
+ * @param {string} options.schema                  Schema of the record.
+ * @param {string} options.objectId                The record id.
+ * @param {object} options.declaration             `{typeField, typeSchema, field, surface}`.
+ * @param {string} options.featuresEndpoint        The endpoint that asks hermiq.
+ * @param {string} options.featuresQueryKey        Query key the slugs are sent under.
+ * @return {Promise<Array<object>|null>} The features, or null when they could not be read.
+ */
+async function fetchFeatures({ apiBase, register, schema, objectId, declaration, featuresEndpoint, featuresQueryKey }) {
+	try {
+		const record = await readObject(apiBase, register, schema, objectId);
+		const typeId = referenceId(record[declaration.typeField]);
+		if (typeId === '') {
+			return []
+		}
+		const typeObject = await readObject(apiBase, register, declaration.typeSchema, typeId);
+		const slugs = surfaceSlugs(typeObject, declaration.field || 'aiFeatures', declaration.surface);
+		if (slugs.length === 0) {
+			return []
+		}
+
+		const query = new URLSearchParams({ surface: declaration.surface });
+		for (const slug of slugs) {
+			query.append(`${featuresQueryKey}[${slug}]`, declaration.surface);
+		}
+		const { data } = await axios__default.get(`${prefixUrl(featuresEndpoint)}?${query.toString()}`);
+		return Array.isArray(data?.features) ? data.features : []
+	} catch {
+		return null
+	}
+}
+
+/**
+ * The record's documents a feature can be run on.
+ *
+ * @param {string} url The files endpoint.
+ * @return {Promise<Array<{id: string, title: string}>|null>} The documents, or null.
+ */
+async function fetchDocuments(url) {
+	try {
+		const { data } = await axios__default.get(prefixUrl(url));
+		const rows = Array.isArray(data?.results) ? data.results : (Array.isArray(data) ? data : []);
+		return rows
+			.filter((row) => row && row.id !== undefined && row.id !== null)
+			.map((row) => ({ id: String(row.id), title: String(row.title ?? row.name ?? row.id) }))
+	} catch {
+		return null
+	}
+}
+
+/**
+ * The prompts offered on the record, as the endpoint holds them.
+ *
+ * @param {string} url The prompts endpoint.
+ * @return {Promise<Array<{id: string, label: string, prompt: string}>|null>} The prompts, or null.
+ */
+async function fetchPrompts(url) {
+	try {
+		const { data } = await axios__default.get(prefixUrl(url));
+		return Array.isArray(data?.prompts) ? data.prompts : []
+	} catch {
+		return null
+	}
+}
+
+/**
+ * Ask one prompt about the record.
+ *
+ * @param {string} url       The ask endpoint.
+ * @param {string} objectKey Body key naming the record.
+ * @param {string} objectId  The record id.
+ * @param {string} message   The prompt.
+ * @return {Promise<object>} `{reply, model?}`.
+ */
+async function askAbout(url, objectKey, objectId, message) {
+	const { data } = await axios__default.post(prefixUrl(url), { [objectKey]: objectId, message });
+	return data
+}
+
+/**
+ * Where a feature runs, in words. A feature hermiq does not offer reads
+ * unavailable, never local.
+ *
+ * @param {object} feature One feature row.
+ * @return {string} The sentence.
+ */
+function whereItRuns(feature) {
+	if (feature?.available !== true) {
+		return translate('nextcloud-vue', 'Unavailable: hermiq does not offer this feature here.')
+	}
+	const provider = String(feature.provider ?? '').trim();
+	const residency = String(feature.residency ?? '').trim();
+	if (provider === '' || residency === '') {
+		return translate('nextcloud-vue', 'hermiq did not say which provider runs this, or where.')
+	}
+	return translate('nextcloud-vue', '{provider}, runs in {residency}', { provider, residency })
+}
+
+/**
+ * Run one AI feature on one document, through hermiq.
+ *
+ * @param {object}        request                   The run.
+ * @param {string}        request.feature           The feature slug.
+ * @param {string|number} request.documentReference The document's file id.
+ * @param {string}        request.instruction       What to do with it.
+ * @param {string}        [request.runEndpoint]     Endpoint template with `{slug}`.
+ * @return {Promise<object>} hermiq's answer.
+ * @throws {AiFeatureRefusal} When the reference is missing, or hermiq refuses.
+ */
+async function runFeatureOnDocument({ feature, documentReference, instruction, runEndpoint = DEFAULT_RUN_ENDPOINT }) {
+	const reference = String(documentReference ?? '').trim();
+	if (/^\d+$/.test(reference) === false) {
+		throw new AiFeatureRefusal(feature, translate('nextcloud-vue', 'No document was chosen.'), MISSING_REFERENCE)
+	}
+
+	const url = prefixUrl(runEndpoint.replace('{slug}', encodeURIComponent(feature)));
+	try {
+		const response = await axios__default.post(url, { documentReference: reference, instruction });
+		return response.data
+	} catch (error) {
+		const status = error?.response?.status;
+		const data = error?.response?.data ?? {};
+		if ([400, 403, 404, 422].includes(status) === true) {
+			throw new AiFeatureRefusal(feature, String(data.error ?? ''), data.gate ?? null)
+		}
+		throw error
+	}
+}
+
+/**
+ * The sentence a reader sees for a refusal, naming the feature and the reason.
+ *
+ * @param {AiFeatureRefusal} refusal      The refusal.
+ * @param {string}           featureLabel The feature's name.
+ * @return {string} The sentence.
+ */
+function refusalSentence(refusal, featureLabel) {
+	if (refusal.gate === MISSING_REFERENCE) {
+		return translate('nextcloud-vue', '{feature} reads a document, and no document was chosen.', { feature: featureLabel })
+	}
+	if (refusal.gate === 'redaction') {
+		return translate('nextcloud-vue', '{feature} will not read a document that has not been redacted.', { feature: featureLabel })
+	}
+	return translate('nextcloud-vue', '{feature} did not run: {reason}', { feature: featureLabel, reason: refusal.reason })
+}
+
+export { AiFeatureRefusal, DEFAULT_RUN_ENDPOINT, MISSING_REFERENCE, askAbout, fetchDocuments, fetchFeatures, fetchPrompts, referenceId, refusalSentence, runFeatureOnDocument, surfaceSlugs, whereItRuns };
+//# sourceMappingURL=aiFeatures.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiFeatures.js","sources":["../../../src/utils/aiFeatures.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * The reads and the run behind CnAiFeaturesWidget: the AI features a record's\n * TYPE object places on a surface, where hermiq runs each one, a run on one of\n * the record's documents, and the sentence a refusal is shown as.\n *\n * An undeclared type asks nobody: the declaration is read first and the\n * features endpoint is called only when something is placed on the surface.\n * Every read answers null when it failed, so the widget can say it is\n * incomplete instead of drawing an empty list.\n *\n * The run goes to hermiq in the reader's own session, so their own access\n * decides which document can be read. A request without a usable document\n * reference is refused before it is sent: hermiq's redaction gate sits on the\n * document, and a request without one would run unchecked.\n */\nimport axios from '@nextcloud/axios'\nimport { translate as t } from '@nextcloud/l10n'\nimport { prefixUrl } from './headers.js'\n\n/** The gate name for a run refused before it was sent. */\nexport const MISSING_REFERENCE = 'missing-reference'\n\n/** The hermiq endpoint a feature runs on a document through; `{slug}` is filled in. */\nexport const DEFAULT_RUN_ENDPOINT = '/apps/hermiq/api/ai-features/{slug}/run-on-document'\n\n/**\n * A run that was refused, before sending or by one of hermiq's gates.\n */\nexport class AiFeatureRefusal extends Error {\n\t/**\n\t * @param {string}      feature The feature slug.\n\t * @param {string}      reason  The refusing side's own sentence.\n\t * @param {string|null} gate    The gate that refused, when named.\n\t */\n\tconstructor(feature, reason, gate) {\n\t\tsuper(reason)\n\t\tthis.name = 'AiFeatureRefusal'\n\t\tthis.feature = feature\n\t\tthis.reason = reason\n\t\tthis.gate = gate\n\t}\n}\n\n/**\n * The id inside a reference that may be a plain id or an object carrying one.\n *\n * @param {string|object|null|undefined} value The reference.\n * @return {string} The id, or ''.\n */\nexport function referenceId(value) {\n\tif (value !== null && typeof value === 'object') {\n\t\treturn String(value.id ?? value.uuid ?? '').trim()\n\t}\n\treturn String(value ?? '').trim()\n}\n\n/**\n * The slugs a type object places on one surface. The declaration is a map of\n * feature slug to surface name.\n *\n * @param {object} typeObject The type object.\n * @param {string} field      The declaration field.\n * @param {string} surface    The surface.\n * @return {Array<string>} The slugs, in declaration order.\n */\nexport function surfaceSlugs(typeObject, field, surface) {\n\tconst declared = typeObject?.[field]\n\tif (declared === null || typeof declared !== 'object' || Array.isArray(declared)) {\n\t\treturn []\n\t}\n\treturn Object.keys(declared).filter((slug) => declared[slug] === surface)\n}\n\n/**\n * Read one OpenRegister object.\n *\n * @param {string} apiBase  API root.\n * @param {string} register Register.\n * @param {string} schema   Schema.\n * @param {string} id       Object id.\n * @return {Promise<object>} The object.\n */\nasync function readObject(apiBase, register, schema, id) {\n\tconst { data } = await axios.get(prefixUrl(`${apiBase}/objects/${register}/${schema}/${encodeURIComponent(id)}`))\n\treturn data?.object ?? data ?? {}\n}\n\n/**\n * The AI features the record's type places on the surface, each with where it\n * runs as the features endpoint answers it.\n *\n * @param {object} options                         The options.\n * @param {string} options.apiBase                 OpenRegister API root.\n * @param {string} options.register                Register.\n * @param {string} options.schema                  Schema of the record.\n * @param {string} options.objectId                The record id.\n * @param {object} options.declaration             `{typeField, typeSchema, field, surface}`.\n * @param {string} options.featuresEndpoint        The endpoint that asks hermiq.\n * @param {string} options.featuresQueryKey        Query key the slugs are sent under.\n * @return {Promise<Array<object>|null>} The features, or null when they could not be read.\n */\nexport async function fetchFeatures({ apiBase, register, schema, objectId, declaration, featuresEndpoint, featuresQueryKey }) {\n\ttry {\n\t\tconst record = await readObject(apiBase, register, schema, objectId)\n\t\tconst typeId = referenceId(record[declaration.typeField])\n\t\tif (typeId === '') {\n\t\t\treturn []\n\t\t}\n\t\tconst typeObject = await readObject(apiBase, register, declaration.typeSchema, typeId)\n\t\tconst slugs = surfaceSlugs(typeObject, declaration.field || 'aiFeatures', declaration.surface)\n\t\tif (slugs.length === 0) {\n\t\t\treturn []\n\t\t}\n\n\t\tconst query = new URLSearchParams({ surface: declaration.surface })\n\t\tfor (const slug of slugs) {\n\t\t\tquery.append(`${featuresQueryKey}[${slug}]`, declaration.surface)\n\t\t}\n\t\tconst { data } = await axios.get(`${prefixUrl(featuresEndpoint)}?${query.toString()}`)\n\t\treturn Array.isArray(data?.features) ? data.features : []\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * The record's documents a feature can be run on.\n *\n * @param {string} url The files endpoint.\n * @return {Promise<Array<{id: string, title: string}>|null>} The documents, or null.\n */\nexport async function fetchDocuments(url) {\n\ttry {\n\t\tconst { data } = await axios.get(prefixUrl(url))\n\t\tconst rows = Array.isArray(data?.results) ? data.results : (Array.isArray(data) ? data : [])\n\t\treturn rows\n\t\t\t.filter((row) => row && row.id !== undefined && row.id !== null)\n\t\t\t.map((row) => ({ id: String(row.id), title: String(row.title ?? row.name ?? row.id) }))\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * The prompts offered on the record, as the endpoint holds them.\n *\n * @param {string} url The prompts endpoint.\n * @return {Promise<Array<{id: string, label: string, prompt: string}>|null>} The prompts, or null.\n */\nexport async function fetchPrompts(url) {\n\ttry {\n\t\tconst { data } = await axios.get(prefixUrl(url))\n\t\treturn Array.isArray(data?.prompts) ? data.prompts : []\n\t} catch {\n\t\treturn null\n\t}\n}\n\n/**\n * Ask one prompt about the record.\n *\n * @param {string} url       The ask endpoint.\n * @param {string} objectKey Body key naming the record.\n * @param {string} objectId  The record id.\n * @param {string} message   The prompt.\n * @return {Promise<object>} `{reply, model?}`.\n */\nexport async function askAbout(url, objectKey, objectId, message) {\n\tconst { data } = await axios.post(prefixUrl(url), { [objectKey]: objectId, message })\n\treturn data\n}\n\n/**\n * Where a feature runs, in words. A feature hermiq does not offer reads\n * unavailable, never local.\n *\n * @param {object} feature One feature row.\n * @return {string} The sentence.\n */\nexport function whereItRuns(feature) {\n\tif (feature?.available !== true) {\n\t\treturn t('nextcloud-vue', 'Unavailable: hermiq does not offer this feature here.')\n\t}\n\tconst provider = String(feature.provider ?? '').trim()\n\tconst residency = String(feature.residency ?? '').trim()\n\tif (provider === '' || residency === '') {\n\t\treturn t('nextcloud-vue', 'hermiq did not say which provider runs this, or where.')\n\t}\n\treturn t('nextcloud-vue', '{provider}, runs in {residency}', { provider, residency })\n}\n\n/**\n * Run one AI feature on one document, through hermiq.\n *\n * @param {object}        request                   The run.\n * @param {string}        request.feature           The feature slug.\n * @param {string|number} request.documentReference The document's file id.\n * @param {string}        request.instruction       What to do with it.\n * @param {string}        [request.runEndpoint]     Endpoint template with `{slug}`.\n * @return {Promise<object>} hermiq's answer.\n * @throws {AiFeatureRefusal} When the reference is missing, or hermiq refuses.\n */\nexport async function runFeatureOnDocument({ feature, documentReference, instruction, runEndpoint = DEFAULT_RUN_ENDPOINT }) {\n\tconst reference = String(documentReference ?? '').trim()\n\tif (/^\\d+$/.test(reference) === false) {\n\t\tthrow new AiFeatureRefusal(feature, t('nextcloud-vue', 'No document was chosen.'), MISSING_REFERENCE)\n\t}\n\n\tconst url = prefixUrl(runEndpoint.replace('{slug}', encodeURIComponent(feature)))\n\ttry {\n\t\tconst response = await axios.post(url, { documentReference: reference, instruction })\n\t\treturn response.data\n\t} catch (error) {\n\t\tconst status = error?.response?.status\n\t\tconst data = error?.response?.data ?? {}\n\t\tif ([400, 403, 404, 422].includes(status) === true) {\n\t\t\tthrow new AiFeatureRefusal(feature, String(data.error ?? ''), data.gate ?? null)\n\t\t}\n\t\tthrow error\n\t}\n}\n\n/**\n * The sentence a reader sees for a refusal, naming the feature and the reason.\n *\n * @param {AiFeatureRefusal} refusal      The refusal.\n * @param {string}           featureLabel The feature's name.\n * @return {string} The sentence.\n */\nexport function refusalSentence(refusal, featureLabel) {\n\tif (refusal.gate === MISSING_REFERENCE) {\n\t\treturn t('nextcloud-vue', '{feature} reads a document, and no document was chosen.', { feature: featureLabel })\n\t}\n\tif (refusal.gate === 'redaction') {\n\t\treturn t('nextcloud-vue', '{feature} will not read a document that has not been redacted.', { feature: featureLabel })\n\t}\n\treturn t('nextcloud-vue', '{feature} did not run: {reason}', { feature: featureLabel, reason: refusal.reason })\n}\n"],"names":["axios","t"],"mappings":"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"}

package/dist/esm/utils/aiSuggestionTracker.js

@@ -0,0 +1,182 @@
+import { getRequestToken } from '@nextcloud/auth';
+import axios__default from '@nextcloud/axios';
+import { prefixUrl } from './headers.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * Reports what a person did with each AI suggestion on a record, for the AI
+ * oversight trail (EU AI Act art. 14). Every suggestion that is shown ends in
+ * exactly one report: accepted, modified or rejected when the person acts on
+ * it, and ignored when they do not. An ignored suggestion says why: a newer
+ * suggestion replaced it (superseded), its surface was closed (closed), or it
+ * stayed open past its lifetime (expired).
+ *
+ * The app's record-action endpoint writes the local audit entry and hands the
+ * decision to hermiq; without hermiq it keeps only the local entry.
+ */
+
+/** How long a shown suggestion waits for a decision before it expires. */
+const SUGGESTION_LIFETIME_MS = 30 * 60 * 1000;
+
+/**
+ * Post one decision to the record-action endpoint.
+ *
+ * @param {string} endpoint The record-action endpoint.
+ * @param {object} body The record-action body.
+ * @param {object} options Options.
+ * @param {boolean} options.leaving True while the page unloads: the request
+ *   then uses `fetch` with `keepalive`, which outlives the page.
+ * @return {Promise<void>}
+ */
+async function postDecision(endpoint, body, { leaving = false } = {}) {
+	const url = prefixUrl(endpoint);
+	if (leaving === true) {
+		await fetch(url, {
+			method: 'POST',
+			keepalive: true,
+			headers: {
+				'Content-Type': 'application/json',
+				requesttoken: getRequestToken() ?? '',
+			},
+			body: JSON.stringify(body),
+		});
+		return
+	}
+
+	await axios__default.post(url, body);
+}
+
+/**
+ * Track the suggestions shown on one record.
+ *
+ * A suggestion is shown under a slot key (one feature, or the questions); a
+ * newer suggestion in the same slot supersedes an undecided older one.
+ *
+ * @param {object} options Options.
+ * @param {string} options.objectId The record id.
+ * @param {string} [options.objectKey] Body key naming the record (default `objectId`).
+ * @param {string} [options.endpoint] The record-action endpoint; empty reports nothing.
+ * @param {function(object, object): Promise<void>} [options.report] Sends one decision; defaults to posting to `endpoint`.
+ * @param {number} [options.lifetimeMs] Lifetime of an undecided suggestion.
+ * @param {function(function(): void, number): number} [options.setTimer] Timer factory, for tests.
+ * @param {function(number): void} [options.clearTimer] Timer cancel, for tests.
+ * @return {object} The tracker: show, decide, dismiss, closeAll, pending.
+ */
+function createSuggestionTracker({
+	objectId,
+	objectKey = 'objectId',
+	endpoint = '',
+	report = (body, options) => (endpoint ? postDecision(endpoint, body, options) : Promise.resolve()),
+	lifetimeMs = SUGGESTION_LIFETIME_MS,
+	setTimer = setTimeout,
+	clearTimer = clearTimeout,
+}) {
+	const pending = new Map();
+	let counter = 0;
+
+	/**
+	 * Send the report for one slot's suggestion and forget it.
+	 *
+	 * @param {string} slot The slot key.
+	 * @param {object} decision `{userAction, unusedBecause?, actualValue?, reason?}`.
+	 * @param {object} options Passed to report.
+	 * @return {Promise<void>}
+	 */
+	function settle(slot, decision, options = {}) {
+		const shown = pending.get(slot);
+		if (shown === undefined) {
+			return Promise.resolve()
+		}
+
+		pending.delete(slot);
+		clearTimer(shown.timer);
+		const body = {
+			[objectKey]: objectId,
+			type: shown.type,
+			suggestion: shown.text,
+			prompt: shown.prompt ?? '',
+			model: shown.model ?? '',
+			documentId: shown.documentId ?? '',
+			suggestionId: shown.id,
+			...decision,
+		};
+
+		return Promise.resolve(report(body, options)).catch(() => {
+			// The person's work must not fail because the oversight trail
+			// could not be written; the server logs its own failures.
+		})
+	}
+
+	return {
+		/**
+		 * Register a suggestion as shown in a slot.
+		 *
+		 * @param {string} slot The slot key.
+		 * @param {object} suggestion `{type, text, prompt?, model?, documentId?}`.
+		 * @return {string} The suggestion id.
+		 */
+		show(slot, suggestion) {
+			settle(slot, { userAction: 'ignored', unusedBecause: 'superseded' });
+			counter += 1;
+			const id = `${Date.now().toString(36)}-${counter}`;
+			const timer = setTimer(() => {
+				settle(slot, { userAction: 'ignored', unusedBecause: 'expired' });
+			}, lifetimeMs);
+			pending.set(slot, { ...suggestion, id, timer });
+			return id
+		},
+
+		/**
+		 * Report the person's decision on a slot's suggestion.
+		 *
+		 * @param {string} slot The slot key.
+		 * @param {string} userAction accepted, modified or rejected.
+		 * @param {object} [extra] `{actualValue?, reason?}`.
+		 * @return {Promise<void>}
+		 */
+		decide(slot, userAction, extra = {}) {
+			return settle(slot, { userAction, ...extra })
+		},
+
+		/**
+		 * Report a slot's undecided suggestion as ignored, for a reason.
+		 *
+		 * @param {string} slot The slot key.
+		 * @param {string} because closed, expired or superseded.
+		 * @return {Promise<void>}
+		 */
+		dismiss(slot, because) {
+			return settle(slot, { userAction: 'ignored', unusedBecause: because })
+		},
+
+		/**
+		 * Report every undecided suggestion as closed.
+		 *
+		 * @param {object} [options] `{leaving}` while the page unloads.
+		 * @return {Promise<void>}
+		 */
+		closeAll(options = {}) {
+			const slots = [...pending.keys()];
+			return Promise.all(slots.map((slot) => settle(
+				slot,
+				{ userAction: 'ignored', unusedBecause: 'closed' },
+				options,
+			))).then(() => undefined)
+		},
+
+		/**
+		 * Whether a slot holds an undecided suggestion.
+		 *
+		 * @param {string} slot The slot key.
+		 * @return {boolean} True while undecided.
+		 */
+		pending(slot) {
+			return pending.has(slot)
+		},
+	}
+}
+
+export { SUGGESTION_LIFETIME_MS, createSuggestionTracker, postDecision };
+//# sourceMappingURL=aiSuggestionTracker.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aiSuggestionTracker.js","sources":["../../../src/utils/aiSuggestionTracker.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Reports what a person did with each AI suggestion on a record, for the AI\n * oversight trail (EU AI Act art. 14). Every suggestion that is shown ends in\n * exactly one report: accepted, modified or rejected when the person acts on\n * it, and ignored when they do not. An ignored suggestion says why: a newer\n * suggestion replaced it (superseded), its surface was closed (closed), or it\n * stayed open past its lifetime (expired).\n *\n * The app's record-action endpoint writes the local audit entry and hands the\n * decision to hermiq; without hermiq it keeps only the local entry.\n */\nimport { getRequestToken } from '@nextcloud/auth'\nimport axios from '@nextcloud/axios'\nimport { prefixUrl } from './headers.js'\n\n/** How long a shown suggestion waits for a decision before it expires. */\nexport const SUGGESTION_LIFETIME_MS = 30 * 60 * 1000\n\n/**\n * Post one decision to the record-action endpoint.\n *\n * @param {string} endpoint The record-action endpoint.\n * @param {object} body The record-action body.\n * @param {object} options Options.\n * @param {boolean} options.leaving True while the page unloads: the request\n *   then uses `fetch` with `keepalive`, which outlives the page.\n * @return {Promise<void>}\n */\nexport async function postDecision(endpoint, body, { leaving = false } = {}) {\n\tconst url = prefixUrl(endpoint)\n\tif (leaving === true) {\n\t\tawait fetch(url, {\n\t\t\tmethod: 'POST',\n\t\t\tkeepalive: true,\n\t\t\theaders: {\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\trequesttoken: getRequestToken() ?? '',\n\t\t\t},\n\t\t\tbody: JSON.stringify(body),\n\t\t})\n\t\treturn\n\t}\n\n\tawait axios.post(url, body)\n}\n\n/**\n * Track the suggestions shown on one record.\n *\n * A suggestion is shown under a slot key (one feature, or the questions); a\n * newer suggestion in the same slot supersedes an undecided older one.\n *\n * @param {object} options Options.\n * @param {string} options.objectId The record id.\n * @param {string} [options.objectKey] Body key naming the record (default `objectId`).\n * @param {string} [options.endpoint] The record-action endpoint; empty reports nothing.\n * @param {function(object, object): Promise<void>} [options.report] Sends one decision; defaults to posting to `endpoint`.\n * @param {number} [options.lifetimeMs] Lifetime of an undecided suggestion.\n * @param {function(function(): void, number): number} [options.setTimer] Timer factory, for tests.\n * @param {function(number): void} [options.clearTimer] Timer cancel, for tests.\n * @return {object} The tracker: show, decide, dismiss, closeAll, pending.\n */\nexport function createSuggestionTracker({\n\tobjectId,\n\tobjectKey = 'objectId',\n\tendpoint = '',\n\treport = (body, options) => (endpoint ? postDecision(endpoint, body, options) : Promise.resolve()),\n\tlifetimeMs = SUGGESTION_LIFETIME_MS,\n\tsetTimer = setTimeout,\n\tclearTimer = clearTimeout,\n}) {\n\tconst pending = new Map()\n\tlet counter = 0\n\n\t/**\n\t * Send the report for one slot's suggestion and forget it.\n\t *\n\t * @param {string} slot The slot key.\n\t * @param {object} decision `{userAction, unusedBecause?, actualValue?, reason?}`.\n\t * @param {object} options Passed to report.\n\t * @return {Promise<void>}\n\t */\n\tfunction settle(slot, decision, options = {}) {\n\t\tconst shown = pending.get(slot)\n\t\tif (shown === undefined) {\n\t\t\treturn Promise.resolve()\n\t\t}\n\n\t\tpending.delete(slot)\n\t\tclearTimer(shown.timer)\n\t\tconst body = {\n\t\t\t[objectKey]: objectId,\n\t\t\ttype: shown.type,\n\t\t\tsuggestion: shown.text,\n\t\t\tprompt: shown.prompt ?? '',\n\t\t\tmodel: shown.model ?? '',\n\t\t\tdocumentId: shown.documentId ?? '',\n\t\t\tsuggestionId: shown.id,\n\t\t\t...decision,\n\t\t}\n\n\t\treturn Promise.resolve(report(body, options)).catch(() => {\n\t\t\t// The person's work must not fail because the oversight trail\n\t\t\t// could not be written; the server logs its own failures.\n\t\t})\n\t}\n\n\treturn {\n\t\t/**\n\t\t * Register a suggestion as shown in a slot.\n\t\t *\n\t\t * @param {string} slot The slot key.\n\t\t * @param {object} suggestion `{type, text, prompt?, model?, documentId?}`.\n\t\t * @return {string} The suggestion id.\n\t\t */\n\t\tshow(slot, suggestion) {\n\t\t\tsettle(slot, { userAction: 'ignored', unusedBecause: 'superseded' })\n\t\t\tcounter += 1\n\t\t\tconst id = `${Date.now().toString(36)}-${counter}`\n\t\t\tconst timer = setTimer(() => {\n\t\t\t\tsettle(slot, { userAction: 'ignored', unusedBecause: 'expired' })\n\t\t\t}, lifetimeMs)\n\t\t\tpending.set(slot, { ...suggestion, id, timer })\n\t\t\treturn id\n\t\t},\n\n\t\t/**\n\t\t * Report the person's decision on a slot's suggestion.\n\t\t *\n\t\t * @param {string} slot The slot key.\n\t\t * @param {string} userAction accepted, modified or rejected.\n\t\t * @param {object} [extra] `{actualValue?, reason?}`.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tdecide(slot, userAction, extra = {}) {\n\t\t\treturn settle(slot, { userAction, ...extra })\n\t\t},\n\n\t\t/**\n\t\t * Report a slot's undecided suggestion as ignored, for a reason.\n\t\t *\n\t\t * @param {string} slot The slot key.\n\t\t * @param {string} because closed, expired or superseded.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tdismiss(slot, because) {\n\t\t\treturn settle(slot, { userAction: 'ignored', unusedBecause: because })\n\t\t},\n\n\t\t/**\n\t\t * Report every undecided suggestion as closed.\n\t\t *\n\t\t * @param {object} [options] `{leaving}` while the page unloads.\n\t\t * @return {Promise<void>}\n\t\t */\n\t\tcloseAll(options = {}) {\n\t\t\tconst slots = [...pending.keys()]\n\t\t\treturn Promise.all(slots.map((slot) => settle(\n\t\t\t\tslot,\n\t\t\t\t{ userAction: 'ignored', unusedBecause: 'closed' },\n\t\t\t\toptions,\n\t\t\t))).then(() => undefined)\n\t\t},\n\n\t\t/**\n\t\t * Whether a slot holds an undecided suggestion.\n\t\t *\n\t\t * @param {string} slot The slot key.\n\t\t * @return {boolean} True while undecided.\n\t\t */\n\t\tpending(slot) {\n\t\t\treturn pending.has(slot)\n\t\t},\n\t}\n}\n"],"names":["axios"],"mappings":";;;;AAAA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AAIA;AACA;AACY,MAAC,sBAAsB,GAAG,EAAE,GAAG,EAAE,GAAG,KAAI;AACpD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,eAAe,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE,OAAO,GAAG,KAAK,EAAE,GAAG,EAAE,EAAE;AAC7E,CAAC,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,EAAC;AAChC,CAAC,IAAI,OAAO,KAAK,IAAI,EAAE;AACvB,EAAE,MAAM,KAAK,CAAC,GAAG,EAAE;AACnB,GAAG,MAAM,EAAE,MAAM;AACjB,GAAG,SAAS,EAAE,IAAI;AAClB,GAAG,OAAO,EAAE;AACZ,IAAI,cAAc,EAAE,kBAAkB;AACtC,IAAI,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE;AACzC,IAAI;AACJ,GAAG,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;AAC7B,GAAG,EAAC;AACJ,EAAE,MAAM;AACR,EAAE;AACF;AACA,CAAC,MAAMA,cAAK,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAC;AAC5B,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,uBAAuB,CAAC;AACxC,CAAC,QAAQ;AACT,CAAC,SAAS,GAAG,UAAU;AACvB,CAAC,QAAQ,GAAG,EAAE;AACd,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,OAAO,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,EAAE,IAAI,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;AACnG,CAAC,UAAU,GAAG,sBAAsB;AACpC,CAAC,QAAQ,GAAG,UAAU;AACtB,CAAC,UAAU,GAAG,YAAY;AAC1B,CAAC,EAAE;AACH,CAAC,MAAM,OAAO,GAAG,IAAI,GAAG,GAAE;AAC1B,CAAC,IAAI,OAAO,GAAG,EAAC;AAChB;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,CAAC,SAAS,MAAM,CAAC,IAAI,EAAE,QAAQ,EAAE,OAAO,GAAG,EAAE,EAAE;AAC/C,EAAE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAC;AACjC,EAAE,IAAI,KAAK,KAAK,SAAS,EAAE;AAC3B,GAAG,OAAO,OAAO,CAAC,OAAO,EAAE;AAC3B,GAAG;AACH;AACA,EAAE,OAAO,CAAC,MAAM,CAAC,IAAI,EAAC;AACtB,EAAE,UAAU,CAAC,KAAK,CAAC,KAAK,EAAC;AACzB,EAAE,MAAM,IAAI,GAAG;AACf,GAAG,CAAC,SAAS,GAAG,QAAQ;AACxB,GAAG,IAAI,EAAE,KAAK,CAAC,IAAI;AACnB,GAAG,UAAU,EAAE,KAAK,CAAC,IAAI;AACzB,GAAG,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,EAAE;AAC7B,GAAG,KAAK,EAAE,KAAK,CAAC,KAAK,IAAI,EAAE;AAC3B,GAAG,UAAU,EAAE,KAAK,CAAC,UAAU,IAAI,EAAE;AACrC,GAAG,YAAY,EAAE,KAAK,CAAC,EAAE;AACzB,GAAG,GAAG,QAAQ;AACd,IAAG;AACH;AACA,EAAE,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,MAAM;AAC5D;AACA;AACA,GAAG,CAAC;AACJ,EAAE;AACF;AACA,CAAC,OAAO;AACR;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE;AACzB,GAAG,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,YAAY,EAAE,EAAC;AACvE,GAAG,OAAO,IAAI,EAAC;AACf,GAAG,MAAM,EAAE,GAAG,CAAC,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAC;AACrD,GAAG,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM;AAChC,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,SAAS,EAAE,EAAC;AACrE,IAAI,EAAE,UAAU,EAAC;AACjB,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,GAAG,UAAU,EAAE,EAAE,EAAE,KAAK,EAAE,EAAC;AAClD,GAAG,OAAO,EAAE;AACZ,GAAG;AACH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,GAAG,EAAE,EAAE;AACvC,GAAG,OAAO,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,GAAG,KAAK,EAAE,CAAC;AAChD,GAAG;AACH;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE;AACzB,GAAG,OAAO,MAAM,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;AACzE,GAAG;AACH;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,QAAQ,CAAC,OAAO,GAAG,EAAE,EAAE;AACzB,GAAG,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,EAAC;AACpC,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,KAAK,MAAM;AAChD,IAAI,IAAI;AACR,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,QAAQ,EAAE;AACtD,IAAI,OAAO;AACX,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,SAAS,CAAC;AAC5B,GAAG;AACH;AACA;AACA;AACA;AACA;AACA;AACA;AACA,EAAE,OAAO,CAAC,IAAI,EAAE;AAChB,GAAG,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC;AAC3B,GAAG;AACH,EAAE;AACF;;;;"}

package/dist/esm/utils/libraryWidgetKeys.js

@@ -76,6 +76,7 @@ const BUILT_IN_WIDGET_KEYS = Object.freeze([
 	'divider',
 	'saved-view-alert',
 	'exports',
+	'object-translations',
 ]);
 
 /**
@@ -151,6 +152,7 @@ const DASHBOARD_CATALOG_WIDGET_KEYS = Object.freeze([
 	'retention',
 	'saved-view',
 	'saved-views',
+	'schema-rules',
 	'sections',
 	'settings-form',
 	'spend-analytics',

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'notice',\n\t'decision-list',\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\t'saved-view-alert',\n\t'exports',\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'ai-chat',\n\t'attention-flag',\n\t'audit-trail',\n\t'banner',\n\t'calendar',\n\t'chart',\n\t'checklist',\n\t'checklist-run',\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'device-frames',\n\t'divider',\n\t'document-review',\n\t'events',\n\t'facts',\n\t'field-list',\n\t'files',\n\t'flow-runs',\n\t'gauge',\n\t'grouped-cards',\n\t'header',\n\t'image',\n\t'interaction-form',\n\t'kb-search',\n\t'label',\n\t'link',\n\t'linked',\n\t'links',\n\t'macros',\n\t'mail',\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'parties',\n\t'party-actions',\n\t'people',\n\t'plan',\n\t'quicklinks',\n\t'radio-cards',\n\t'record-list',\n\t'related',\n\t'retention',\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'status-explainer',\n\t'switch-rows',\n\t'table',\n\t'tabs',\n\t'tasks',\n\t'team-workload',\n\t'text',\n\t'tile',\n\t'timeline',\n\t'toggle-table',\n\t'video',\n\t'week-strip',\n\t'working-calendar',\n\t'work-queue',\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":"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"}
+{"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'notice',\n\t'decision-list',\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\t'saved-view-alert',\n\t'exports',\n\t'object-translations',\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'ai-chat',\n\t'attention-flag',\n\t'audit-trail',\n\t'banner',\n\t'calendar',\n\t'chart',\n\t'checklist',\n\t'checklist-run',\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'device-frames',\n\t'divider',\n\t'document-review',\n\t'events',\n\t'facts',\n\t'field-list',\n\t'files',\n\t'flow-runs',\n\t'gauge',\n\t'grouped-cards',\n\t'header',\n\t'image',\n\t'interaction-form',\n\t'kb-search',\n\t'label',\n\t'link',\n\t'linked',\n\t'links',\n\t'macros',\n\t'mail',\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'parties',\n\t'party-actions',\n\t'people',\n\t'plan',\n\t'quicklinks',\n\t'radio-cards',\n\t'record-list',\n\t'related',\n\t'retention',\n\t'saved-view',\n\t'saved-views',\n\t'schema-rules',\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'status-explainer',\n\t'switch-rows',\n\t'table',\n\t'tabs',\n\t'tasks',\n\t'team-workload',\n\t'text',\n\t'tile',\n\t'timeline',\n\t'toggle-table',\n\t'video',\n\t'week-strip',\n\t'working-calendar',\n\t'work-queue',\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":"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"}