@conduction/nextcloud-vue 2.119.0 → 2.121.0

package/dist/esm/utils/objectTranslations.js

@@ -0,0 +1,180 @@
+import axios__default from '@nextcloud/axios';
+import { prefixUrl } from './headers.js';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * The OpenRegister translation reads and the one write behind
+ * CnObjectTranslationsWidget. The engine is OpenRegister's; nothing here
+ * translates or stores anything of its own.
+ *
+ *   GET   {apiBase}/registers/{register}                       languages, source first
+ *   GET   {apiBase}/registers/{register}/schemas                property titles
+ *   GET   {apiBase}/objects/{register}/{schema}/{id}?_translations=all&_translationMeta=true
+ *   GET   {apiBase}/translations/object/{uuid}?schema={schema}   per-value workflow status
+ *   PATCH {apiBase}/objects/{register}/{schema}/{id}             { property: languageMap }
+ *
+ * The WHOLE language map is written and no `X-Translation-Target-Language` is
+ * sent: OpenRegister refuses a language-keyed body that arrives with that
+ * header, and keeps one that arrives without it.
+ *
+ * The translatable properties come from `_meta.languageMeta`, which OpenRegister
+ * builds from the schema it imported, so a property it never read as
+ * translatable is not offered.
+ *
+ * A failed read throws: an outage and an object with nothing translated look
+ * the same from the browser, and only one of them is somebody's problem.
+ */
+
+/** The OpenRegister API root a target defaults to. */
+const DEFAULT_API_BASE = '/apps/openregister/api';
+
+/**
+ * A translation row is stale when the source value moved under it; OpenRegister
+ * flips a derived row to `outdated`. A stale value does not count as translated.
+ *
+ * @type {string}
+ */
+const STATUS_OUTDATED = 'outdated';
+
+/**
+ * The slug of a schema given as a slug or as the schema object.
+ *
+ * @param {string|object} schema The schema.
+ * @return {string} The slug (or id).
+ */
+function schemaSlugOf(schema) {
+	if (schema && typeof schema === 'object') {
+		return String(schema.slug || schema.id || schema.uuid || '')
+	}
+	return String(schema || '')
+}
+
+/**
+ * Normalise a target to `{register, schema, apiBase}`.
+ *
+ * @param {object} target `{register, schema, apiBase?}`.
+ * @return {{register: string, schema: string, apiBase: string}} The target.
+ */
+function normalise(target = {}) {
+	return {
+		register: String(target.register || ''),
+		schema: schemaSlugOf(target.schema),
+		apiBase: String(target.apiBase || DEFAULT_API_BASE).replace(/\/$/, ''),
+	}
+}
+
+/**
+ * The languages the register serves, source language first.
+ *
+ * @param {object} target The target.
+ * @return {Promise<string[]>} The language codes.
+ */
+async function registerLanguages(target) {
+	const { apiBase, register } = normalise(target);
+	const { data } = await axios__default.get(prefixUrl(`${apiBase}/registers/${register}`));
+	const languages = data?.languages ?? data?.register?.languages ?? [];
+	return Array.isArray(languages) ? languages.filter((code) => typeof code === 'string' && code !== '') : []
+}
+
+/**
+ * One object with every language of every value, and its label envelope.
+ *
+ * @param {object} target The target.
+ * @param {string} id     The object id.
+ * @return {Promise<{object: object, languageMeta: object}>} The values and the envelope.
+ */
+async function objectWithTranslations(target, id) {
+	const { apiBase, register, schema } = normalise(target);
+	const { data } = await axios__default.get(
+		prefixUrl(`${apiBase}/objects/${register}/${schema}/${encodeURIComponent(id)}`),
+		{ params: { _translations: 'all', _translationMeta: 'true' } },
+	);
+	const object = data?.object ?? data ?? {};
+	return { object, languageMeta: object?._meta?.languageMeta ?? {} }
+}
+
+/**
+ * The schema's property definitions, for their titles (`languageMeta` carries
+ * none).
+ *
+ * @param {object} target The target.
+ * @return {Promise<object>} Property name to its definition.
+ */
+async function schemaProperties(target) {
+	const { apiBase, register, schema } = normalise(target);
+	const { data } = await axios__default.get(prefixUrl(`${apiBase}/registers/${register}/schemas`));
+	const schemas = data?.results ?? data?.schemas ?? data ?? [];
+	const list = Array.isArray(schemas) ? schemas : Object.values(schemas);
+	const found = list.find((entry) => [entry?.slug, entry?.id, entry?.uuid, entry?.title].map((v) => (v === undefined || v === null) ? '' : String(v)).includes(schema));
+	return found?.properties ?? {}
+}
+
+/**
+ * The sidecar rows for one object, so a stale value can be told apart.
+ *
+ * @param {object} target The target.
+ * @param {string} uuid   The object uuid.
+ * @return {Promise<Array<object>>} Rows naming property, language and status.
+ */
+async function translationRows(target, uuid) {
+	const { apiBase, schema } = normalise(target);
+	const { data } = await axios__default.get(
+		prefixUrl(`${apiBase}/translations/object/${encodeURIComponent(uuid)}`),
+		{ params: { schema } },
+	);
+	const rows = data?.translations ?? [];
+	return Array.isArray(rows) ? rows : []
+}
+
+/**
+ * Write one property back with every language it now holds.
+ *
+ * @param {object} target      The target.
+ * @param {string} id          The object id.
+ * @param {string} property    The property.
+ * @param {object} languageMap Every language of it, the edit included.
+ * @return {Promise<object>} The saved object.
+ */
+async function saveTranslatedProperty(target, id, property, languageMap) {
+	const { apiBase, register, schema } = normalise(target);
+	const { data } = await axios__default.patch(
+		prefixUrl(`${apiBase}/objects/${register}/${schema}/${encodeURIComponent(id)}`),
+		{ [property]: languageMap },
+	);
+	return data?.object ?? data ?? {}
+}
+
+/**
+ * How many of a language's properties are present AND current.
+ *
+ * Deliberately not OpenRegister's `completeness`, which counts every non-empty
+ * row and never reads its status: a stale value is a wrong value. The source
+ * language is complete by definition for every non-empty value.
+ *
+ * @param {object}   args                The inputs.
+ * @param {string[]} args.properties     The translatable properties.
+ * @param {object}   args.values         Property to language to value.
+ * @param {object}   args.statuses       Property to language to status.
+ * @param {string}   args.language       The language counted.
+ * @param {string}   args.sourceLanguage The source language.
+ * @return {{translated: number, total: number}} The counts.
+ */
+function completenessOf({ properties, values, statuses, language, sourceLanguage }) {
+	const total = properties.length;
+	const translated = properties.filter((property) => {
+		const value = values?.[property]?.[language] ?? '';
+		if (typeof value !== 'string' || value.trim() === '') {
+			return false
+		}
+		if (language === sourceLanguage) {
+			return true
+		}
+		return (statuses?.[property]?.[language] ?? '') !== STATUS_OUTDATED
+	}).length;
+	return { translated, total }
+}
+
+export { DEFAULT_API_BASE, STATUS_OUTDATED, completenessOf, objectWithTranslations, registerLanguages, saveTranslatedProperty, schemaProperties, schemaSlugOf, translationRows };
+//# sourceMappingURL=objectTranslations.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"objectTranslations.js","sources":["../../../src/utils/objectTranslations.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * The OpenRegister translation reads and the one write behind\n * CnObjectTranslationsWidget. The engine is OpenRegister's; nothing here\n * translates or stores anything of its own.\n *\n *   GET   {apiBase}/registers/{register}                       languages, source first\n *   GET   {apiBase}/registers/{register}/schemas                property titles\n *   GET   {apiBase}/objects/{register}/{schema}/{id}?_translations=all&_translationMeta=true\n *   GET   {apiBase}/translations/object/{uuid}?schema={schema}   per-value workflow status\n *   PATCH {apiBase}/objects/{register}/{schema}/{id}             { property: languageMap }\n *\n * The WHOLE language map is written and no `X-Translation-Target-Language` is\n * sent: OpenRegister refuses a language-keyed body that arrives with that\n * header, and keeps one that arrives without it.\n *\n * The translatable properties come from `_meta.languageMeta`, which OpenRegister\n * builds from the schema it imported, so a property it never read as\n * translatable is not offered.\n *\n * A failed read throws: an outage and an object with nothing translated look\n * the same from the browser, and only one of them is somebody's problem.\n */\nimport axios from '@nextcloud/axios'\nimport { prefixUrl } from './headers.js'\n\n/** The OpenRegister API root a target defaults to. */\nexport const DEFAULT_API_BASE = '/apps/openregister/api'\n\n/**\n * A translation row is stale when the source value moved under it; OpenRegister\n * flips a derived row to `outdated`. A stale value does not count as translated.\n *\n * @type {string}\n */\nexport const STATUS_OUTDATED = 'outdated'\n\n/**\n * The slug of a schema given as a slug or as the schema object.\n *\n * @param {string|object} schema The schema.\n * @return {string} The slug (or id).\n */\nexport function schemaSlugOf(schema) {\n\tif (schema && typeof schema === 'object') {\n\t\treturn String(schema.slug || schema.id || schema.uuid || '')\n\t}\n\treturn String(schema || '')\n}\n\n/**\n * Normalise a target to `{register, schema, apiBase}`.\n *\n * @param {object} target `{register, schema, apiBase?}`.\n * @return {{register: string, schema: string, apiBase: string}} The target.\n */\nfunction normalise(target = {}) {\n\treturn {\n\t\tregister: String(target.register || ''),\n\t\tschema: schemaSlugOf(target.schema),\n\t\tapiBase: String(target.apiBase || DEFAULT_API_BASE).replace(/\\/$/, ''),\n\t}\n}\n\n/**\n * The languages the register serves, source language first.\n *\n * @param {object} target The target.\n * @return {Promise<string[]>} The language codes.\n */\nexport async function registerLanguages(target) {\n\tconst { apiBase, register } = normalise(target)\n\tconst { data } = await axios.get(prefixUrl(`${apiBase}/registers/${register}`))\n\tconst languages = data?.languages ?? data?.register?.languages ?? []\n\treturn Array.isArray(languages) ? languages.filter((code) => typeof code === 'string' && code !== '') : []\n}\n\n/**\n * One object with every language of every value, and its label envelope.\n *\n * @param {object} target The target.\n * @param {string} id     The object id.\n * @return {Promise<{object: object, languageMeta: object}>} The values and the envelope.\n */\nexport async function objectWithTranslations(target, id) {\n\tconst { apiBase, register, schema } = normalise(target)\n\tconst { data } = await axios.get(\n\t\tprefixUrl(`${apiBase}/objects/${register}/${schema}/${encodeURIComponent(id)}`),\n\t\t{ params: { _translations: 'all', _translationMeta: 'true' } },\n\t)\n\tconst object = data?.object ?? data ?? {}\n\treturn { object, languageMeta: object?._meta?.languageMeta ?? {} }\n}\n\n/**\n * The schema's property definitions, for their titles (`languageMeta` carries\n * none).\n *\n * @param {object} target The target.\n * @return {Promise<object>} Property name to its definition.\n */\nexport async function schemaProperties(target) {\n\tconst { apiBase, register, schema } = normalise(target)\n\tconst { data } = await axios.get(prefixUrl(`${apiBase}/registers/${register}/schemas`))\n\tconst schemas = data?.results ?? data?.schemas ?? data ?? []\n\tconst list = Array.isArray(schemas) ? schemas : Object.values(schemas)\n\tconst found = list.find((entry) => [entry?.slug, entry?.id, entry?.uuid, entry?.title].map((v) => (v === undefined || v === null) ? '' : String(v)).includes(schema))\n\treturn found?.properties ?? {}\n}\n\n/**\n * The sidecar rows for one object, so a stale value can be told apart.\n *\n * @param {object} target The target.\n * @param {string} uuid   The object uuid.\n * @return {Promise<Array<object>>} Rows naming property, language and status.\n */\nexport async function translationRows(target, uuid) {\n\tconst { apiBase, schema } = normalise(target)\n\tconst { data } = await axios.get(\n\t\tprefixUrl(`${apiBase}/translations/object/${encodeURIComponent(uuid)}`),\n\t\t{ params: { schema } },\n\t)\n\tconst rows = data?.translations ?? []\n\treturn Array.isArray(rows) ? rows : []\n}\n\n/**\n * Write one property back with every language it now holds.\n *\n * @param {object} target      The target.\n * @param {string} id          The object id.\n * @param {string} property    The property.\n * @param {object} languageMap Every language of it, the edit included.\n * @return {Promise<object>} The saved object.\n */\nexport async function saveTranslatedProperty(target, id, property, languageMap) {\n\tconst { apiBase, register, schema } = normalise(target)\n\tconst { data } = await axios.patch(\n\t\tprefixUrl(`${apiBase}/objects/${register}/${schema}/${encodeURIComponent(id)}`),\n\t\t{ [property]: languageMap },\n\t)\n\treturn data?.object ?? data ?? {}\n}\n\n/**\n * How many of a language's properties are present AND current.\n *\n * Deliberately not OpenRegister's `completeness`, which counts every non-empty\n * row and never reads its status: a stale value is a wrong value. The source\n * language is complete by definition for every non-empty value.\n *\n * @param {object}   args                The inputs.\n * @param {string[]} args.properties     The translatable properties.\n * @param {object}   args.values         Property to language to value.\n * @param {object}   args.statuses       Property to language to status.\n * @param {string}   args.language       The language counted.\n * @param {string}   args.sourceLanguage The source language.\n * @return {{translated: number, total: number}} The counts.\n */\nexport function completenessOf({ properties, values, statuses, language, sourceLanguage }) {\n\tconst total = properties.length\n\tconst translated = properties.filter((property) => {\n\t\tconst value = values?.[property]?.[language] ?? ''\n\t\tif (typeof value !== 'string' || value.trim() === '') {\n\t\t\treturn false\n\t\t}\n\t\tif (language === sourceLanguage) {\n\t\t\treturn true\n\t\t}\n\t\treturn (statuses?.[property]?.[language] ?? '') !== STATUS_OUTDATED\n\t}).length\n\treturn { translated, total }\n}\n"],"names":["axios"],"mappings":"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"}

package/dist/esm/utils/stateMachineValidation.js

@@ -0,0 +1,254 @@
+import { translate } from '@nextcloud/l10n';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * Structural validation of a state machine: states as nodes, transitions as
+ * directed edges between them. Used by CnStateMachineEditor for itemised
+ * feedback before a host saves or publishes; a host's server remains the
+ * authority on what it accepts.
+ *
+ * @module utils/stateMachineValidation
+ */
+
+
+/** Rule codes, one per kind of issue. */
+const STATE_MACHINE_RULES = Object.freeze({
+	NO_FINAL_STATE: 'NO_FINAL_STATE',
+	UNREACHABLE_FINAL: 'UNREACHABLE_FINAL',
+	DANGLING_TRANSITION: 'DANGLING_TRANSITION',
+	DUPLICATE_TRANSITION: 'DUPLICATE_TRANSITION',
+	ORPHAN_STATE: 'ORPHAN_STATE',
+	CYCLE_NO_EXIT: 'CYCLE_NO_EXIT',
+});
+
+/**
+ * The record keys the validator reads, by role. A host whose records use other
+ * names passes its own (`{ final: 'isFinal', from: 'fromStatus' }`).
+ */
+const DEFAULT_STATE_MACHINE_KEYS = Object.freeze({
+	id: 'id',
+	label: 'label',
+	final: 'final',
+	from: 'from',
+	to: 'to',
+	transitionLabel: 'label',
+});
+
+/**
+ * The default message of each rule, in the library's own domain.
+ *
+ * @return {object} Messages by rule code.
+ */
+function defaultMessages() {
+	return {
+		NO_FINAL_STATE: translate('nextcloud-vue', 'No state is marked as final'),
+		UNREACHABLE_FINAL: translate('nextcloud-vue', 'Final state "{name}" cannot be reached from any starting state'),
+		DANGLING_TRANSITION: translate('nextcloud-vue', 'Transition "{label}" points at a state that no longer exists'),
+		DUPLICATE_TRANSITION: translate('nextcloud-vue', 'Duplicate transition from "{from}" to "{to}"'),
+		ORPHAN_STATE: translate('nextcloud-vue', 'State "{name}" has no transitions connecting it to the others'),
+		CYCLE_NO_EXIT: translate('nextcloud-vue', 'Cycle with no way out to a final state: {names}'),
+	}
+}
+
+/**
+ * Normalise a list that may arrive as a JSON string or an array.
+ *
+ * @param {string|Array|null|undefined} raw The value.
+ * @return {Array} The array, or [] when it is neither.
+ */
+function asList(raw) {
+	if (Array.isArray(raw)) {
+		return raw
+	}
+	if (typeof raw === 'string' && raw !== '') {
+		try {
+			const parsed = JSON.parse(raw);
+			return Array.isArray(parsed) ? parsed : []
+		} catch {
+			return []
+		}
+	}
+	return []
+}
+
+/**
+ * Fill `{name}` placeholders.
+ *
+ * @param {string} text The text.
+ * @param {object} vars Values by placeholder.
+ * @return {string} The filled text.
+ */
+function fill(text, vars) {
+	return String(text).replace(/\{(\w+)\}/g, (match, name) => (Object.hasOwn(vars, name) ? String(vars[name]) : match))
+}
+
+/**
+ * Validate a state machine.
+ *
+ * Errors block (no final state, a final state no start reaches, a transition to
+ * a state that is gone); warnings inform (duplicates, isolated states, cycles
+ * that never reach a final state). An empty machine has no issues: it is
+ * unfinished, not wrong.
+ *
+ * @param {object} graph The machine.
+ * @param {Array|string} graph.states The states.
+ * @param {Array|string} graph.transitions The transitions.
+ * @param {object} [options] Options.
+ * @param {object} [options.keys] Record keys by role, see DEFAULT_STATE_MACHINE_KEYS.
+ * @param {object} [options.messages] Message templates by rule code, overriding the defaults.
+ * @param {(text: string) => string} [options.translate] Applied to an overriding message before its placeholders are filled.
+ * @return {Array<{type: string, code: string, message: string}>} The issues.
+ */
+function validateStateMachine({ states, transitions } = {}, options = {}) {
+	const keys = { ...DEFAULT_STATE_MACHINE_KEYS, ...(options.keys || {}) };
+	const translate = typeof options.translate === 'function' ? options.translate : (text) => text;
+	const own = options.messages || {};
+	const defaults = defaultMessages();
+	const message = (code, vars) => {
+		const template = typeof own[code] === 'string' && own[code] !== '' ? translate(own[code]) : defaults[code];
+		return fill(template, vars)
+	};
+
+	const nodes = asList(states);
+	const edges = asList(transitions);
+	const issues = [];
+	if (nodes.length === 0) {
+		return issues
+	}
+
+	const idOf = (node) => node[keys.id];
+	const nodeIds = new Set(nodes.map(idOf));
+	const nameOf = (id) => {
+		const node = nodes.find((candidate) => idOf(candidate) === id);
+		return (node && node[keys.label]) || id
+	};
+
+	const validEdges = [];
+	edges.forEach((edge) => {
+		const from = edge[keys.from];
+		const to = edge[keys.to];
+		if (!nodeIds.has(from) || !nodeIds.has(to)) {
+			issues.push({
+				type: 'error',
+				code: STATE_MACHINE_RULES.DANGLING_TRANSITION,
+				message: message('DANGLING_TRANSITION', { label: edge[keys.transitionLabel] || `${from} → ${to}` }),
+			});
+			return
+		}
+		validEdges.push(edge);
+	});
+
+	const seenPairs = new Set();
+	validEdges.forEach((edge) => {
+		const pair = `${edge[keys.from]}::${edge[keys.to]}`;
+		if (seenPairs.has(pair)) {
+			issues.push({
+				type: 'warning',
+				code: STATE_MACHINE_RULES.DUPLICATE_TRANSITION,
+				message: message('DUPLICATE_TRANSITION', { from: nameOf(edge[keys.from]), to: nameOf(edge[keys.to]) }),
+			});
+		}
+		seenPairs.add(pair);
+	});
+
+	const finals = nodes.filter((node) => node[keys.final] === true);
+	if (finals.length === 0) {
+		issues.push({
+			type: 'error',
+			code: STATE_MACHINE_RULES.NO_FINAL_STATE,
+			message: message('NO_FINAL_STATE', {}),
+		});
+	}
+
+	const forward = new Map(nodes.map((node) => [idOf(node), []]));
+	const reverse = new Map(nodes.map((node) => [idOf(node), []]));
+	validEdges.forEach((edge) => {
+		forward.get(edge[keys.from]).push(edge[keys.to]);
+		reverse.get(edge[keys.to]).push(edge[keys.from]);
+	});
+
+	if (nodes.length > 1) {
+		nodes.forEach((node) => {
+			if (reverse.get(idOf(node)).length === 0 && forward.get(idOf(node)).length === 0) {
+				issues.push({
+					type: 'warning',
+					code: STATE_MACHINE_RULES.ORPHAN_STATE,
+					message: message('ORPHAN_STATE', { name: node[keys.label] || idOf(node) }),
+				});
+			}
+		});
+	}
+
+	// Starting states are those nothing leads into. When every state has an
+	// incoming transition there is no entry point, so nothing is reachable.
+	const reachable = new Set();
+	const queue = nodes.filter((node) => reverse.get(idOf(node)).length === 0).map(idOf);
+	while (queue.length > 0) {
+		const current = queue.shift();
+		if (!reachable.has(current)) {
+			reachable.add(current);
+			forward.get(current).forEach((next) => queue.push(next));
+		}
+	}
+	finals.forEach((node) => {
+		if (!reachable.has(idOf(node))) {
+			issues.push({
+				type: 'error',
+				code: STATE_MACHINE_RULES.UNREACHABLE_FINAL,
+				message: message('UNREACHABLE_FINAL', { name: node[keys.label] || idOf(node) }),
+			});
+		}
+	});
+
+	const reachesFinal = new Set(finals.map(idOf));
+	const back = finals.map(idOf);
+	while (back.length > 0) {
+		reverse.get(back.shift()).forEach((previous) => {
+			if (!reachesFinal.has(previous)) {
+				reachesFinal.add(previous);
+				back.push(previous);
+			}
+		});
+	}
+
+	const WHITE = 0;
+	const GREY = 1;
+	const BLACK = 2;
+	const colour = new Map(nodes.map((node) => [idOf(node), WHITE]));
+	const stack = [];
+	const reported = new Set();
+	const visit = (id) => {
+		colour.set(id, GREY);
+		stack.push(id);
+		forward.get(id).forEach((next) => {
+			if (colour.get(next) === GREY) {
+				const cycle = stack.slice(stack.indexOf(next));
+				const cycleKey = [...cycle].sort().join(',');
+				if (!reported.has(cycleKey) && !cycle.some((member) => reachesFinal.has(member))) {
+					reported.add(cycleKey);
+					issues.push({
+						type: 'warning',
+						code: STATE_MACHINE_RULES.CYCLE_NO_EXIT,
+						message: message('CYCLE_NO_EXIT', { names: cycle.map(nameOf).join(' → ') }),
+					});
+				}
+			} else if (colour.get(next) === WHITE) {
+				visit(next);
+			}
+		});
+		stack.pop();
+		colour.set(id, BLACK);
+	};
+	nodes.forEach((node) => {
+		if (colour.get(idOf(node)) === WHITE) {
+			visit(idOf(node));
+		}
+	});
+
+	return issues
+}
+
+export { DEFAULT_STATE_MACHINE_KEYS, STATE_MACHINE_RULES, asList, validateStateMachine };
+//# sourceMappingURL=stateMachineValidation.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stateMachineValidation.js","sources":["../../../src/utils/stateMachineValidation.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>\n * SPDX-License-Identifier: EUPL-1.2\n *\n * Structural validation of a state machine: states as nodes, transitions as\n * directed edges between them. Used by CnStateMachineEditor for itemised\n * feedback before a host saves or publishes; a host's server remains the\n * authority on what it accepts.\n *\n * @module utils/stateMachineValidation\n */\n\nimport { translate as t } from '@nextcloud/l10n'\n\n/** Rule codes, one per kind of issue. */\nexport const STATE_MACHINE_RULES = Object.freeze({\n\tNO_FINAL_STATE: 'NO_FINAL_STATE',\n\tUNREACHABLE_FINAL: 'UNREACHABLE_FINAL',\n\tDANGLING_TRANSITION: 'DANGLING_TRANSITION',\n\tDUPLICATE_TRANSITION: 'DUPLICATE_TRANSITION',\n\tORPHAN_STATE: 'ORPHAN_STATE',\n\tCYCLE_NO_EXIT: 'CYCLE_NO_EXIT',\n})\n\n/**\n * The record keys the validator reads, by role. A host whose records use other\n * names passes its own (`{ final: 'isFinal', from: 'fromStatus' }`).\n */\nexport const DEFAULT_STATE_MACHINE_KEYS = Object.freeze({\n\tid: 'id',\n\tlabel: 'label',\n\tfinal: 'final',\n\tfrom: 'from',\n\tto: 'to',\n\ttransitionLabel: 'label',\n})\n\n/**\n * The default message of each rule, in the library's own domain.\n *\n * @return {object} Messages by rule code.\n */\nfunction defaultMessages() {\n\treturn {\n\t\tNO_FINAL_STATE: t('nextcloud-vue', 'No state is marked as final'),\n\t\tUNREACHABLE_FINAL: t('nextcloud-vue', 'Final state \"{name}\" cannot be reached from any starting state'),\n\t\tDANGLING_TRANSITION: t('nextcloud-vue', 'Transition \"{label}\" points at a state that no longer exists'),\n\t\tDUPLICATE_TRANSITION: t('nextcloud-vue', 'Duplicate transition from \"{from}\" to \"{to}\"'),\n\t\tORPHAN_STATE: t('nextcloud-vue', 'State \"{name}\" has no transitions connecting it to the others'),\n\t\tCYCLE_NO_EXIT: t('nextcloud-vue', 'Cycle with no way out to a final state: {names}'),\n\t}\n}\n\n/**\n * Normalise a list that may arrive as a JSON string or an array.\n *\n * @param {string|Array|null|undefined} raw The value.\n * @return {Array} The array, or [] when it is neither.\n */\nexport function asList(raw) {\n\tif (Array.isArray(raw)) {\n\t\treturn raw\n\t}\n\tif (typeof raw === 'string' && raw !== '') {\n\t\ttry {\n\t\t\tconst parsed = JSON.parse(raw)\n\t\t\treturn Array.isArray(parsed) ? parsed : []\n\t\t} catch {\n\t\t\treturn []\n\t\t}\n\t}\n\treturn []\n}\n\n/**\n * Fill `{name}` placeholders.\n *\n * @param {string} text The text.\n * @param {object} vars Values by placeholder.\n * @return {string} The filled text.\n */\nfunction fill(text, vars) {\n\treturn String(text).replace(/\\{(\\w+)\\}/g, (match, name) => (Object.hasOwn(vars, name) ? String(vars[name]) : match))\n}\n\n/**\n * Validate a state machine.\n *\n * Errors block (no final state, a final state no start reaches, a transition to\n * a state that is gone); warnings inform (duplicates, isolated states, cycles\n * that never reach a final state). An empty machine has no issues: it is\n * unfinished, not wrong.\n *\n * @param {object} graph The machine.\n * @param {Array|string} graph.states The states.\n * @param {Array|string} graph.transitions The transitions.\n * @param {object} [options] Options.\n * @param {object} [options.keys] Record keys by role, see DEFAULT_STATE_MACHINE_KEYS.\n * @param {object} [options.messages] Message templates by rule code, overriding the defaults.\n * @param {(text: string) => string} [options.translate] Applied to an overriding message before its placeholders are filled.\n * @return {Array<{type: string, code: string, message: string}>} The issues.\n */\nexport function validateStateMachine({ states, transitions } = {}, options = {}) {\n\tconst keys = { ...DEFAULT_STATE_MACHINE_KEYS, ...(options.keys || {}) }\n\tconst translate = typeof options.translate === 'function' ? options.translate : (text) => text\n\tconst own = options.messages || {}\n\tconst defaults = defaultMessages()\n\tconst message = (code, vars) => {\n\t\tconst template = typeof own[code] === 'string' && own[code] !== '' ? translate(own[code]) : defaults[code]\n\t\treturn fill(template, vars)\n\t}\n\n\tconst nodes = asList(states)\n\tconst edges = asList(transitions)\n\tconst issues = []\n\tif (nodes.length === 0) {\n\t\treturn issues\n\t}\n\n\tconst idOf = (node) => node[keys.id]\n\tconst nodeIds = new Set(nodes.map(idOf))\n\tconst nameOf = (id) => {\n\t\tconst node = nodes.find((candidate) => idOf(candidate) === id)\n\t\treturn (node && node[keys.label]) || id\n\t}\n\n\tconst validEdges = []\n\tedges.forEach((edge) => {\n\t\tconst from = edge[keys.from]\n\t\tconst to = edge[keys.to]\n\t\tif (!nodeIds.has(from) || !nodeIds.has(to)) {\n\t\t\tissues.push({\n\t\t\t\ttype: 'error',\n\t\t\t\tcode: STATE_MACHINE_RULES.DANGLING_TRANSITION,\n\t\t\t\tmessage: message('DANGLING_TRANSITION', { label: edge[keys.transitionLabel] || `${from} → ${to}` }),\n\t\t\t})\n\t\t\treturn\n\t\t}\n\t\tvalidEdges.push(edge)\n\t})\n\n\tconst seenPairs = new Set()\n\tvalidEdges.forEach((edge) => {\n\t\tconst pair = `${edge[keys.from]}::${edge[keys.to]}`\n\t\tif (seenPairs.has(pair)) {\n\t\t\tissues.push({\n\t\t\t\ttype: 'warning',\n\t\t\t\tcode: STATE_MACHINE_RULES.DUPLICATE_TRANSITION,\n\t\t\t\tmessage: message('DUPLICATE_TRANSITION', { from: nameOf(edge[keys.from]), to: nameOf(edge[keys.to]) }),\n\t\t\t})\n\t\t}\n\t\tseenPairs.add(pair)\n\t})\n\n\tconst finals = nodes.filter((node) => node[keys.final] === true)\n\tif (finals.length === 0) {\n\t\tissues.push({\n\t\t\ttype: 'error',\n\t\t\tcode: STATE_MACHINE_RULES.NO_FINAL_STATE,\n\t\t\tmessage: message('NO_FINAL_STATE', {}),\n\t\t})\n\t}\n\n\tconst forward = new Map(nodes.map((node) => [idOf(node), []]))\n\tconst reverse = new Map(nodes.map((node) => [idOf(node), []]))\n\tvalidEdges.forEach((edge) => {\n\t\tforward.get(edge[keys.from]).push(edge[keys.to])\n\t\treverse.get(edge[keys.to]).push(edge[keys.from])\n\t})\n\n\tif (nodes.length > 1) {\n\t\tnodes.forEach((node) => {\n\t\t\tif (reverse.get(idOf(node)).length === 0 && forward.get(idOf(node)).length === 0) {\n\t\t\t\tissues.push({\n\t\t\t\t\ttype: 'warning',\n\t\t\t\t\tcode: STATE_MACHINE_RULES.ORPHAN_STATE,\n\t\t\t\t\tmessage: message('ORPHAN_STATE', { name: node[keys.label] || idOf(node) }),\n\t\t\t\t})\n\t\t\t}\n\t\t})\n\t}\n\n\t// Starting states are those nothing leads into. When every state has an\n\t// incoming transition there is no entry point, so nothing is reachable.\n\tconst reachable = new Set()\n\tconst queue = nodes.filter((node) => reverse.get(idOf(node)).length === 0).map(idOf)\n\twhile (queue.length > 0) {\n\t\tconst current = queue.shift()\n\t\tif (!reachable.has(current)) {\n\t\t\treachable.add(current)\n\t\t\tforward.get(current).forEach((next) => queue.push(next))\n\t\t}\n\t}\n\tfinals.forEach((node) => {\n\t\tif (!reachable.has(idOf(node))) {\n\t\t\tissues.push({\n\t\t\t\ttype: 'error',\n\t\t\t\tcode: STATE_MACHINE_RULES.UNREACHABLE_FINAL,\n\t\t\t\tmessage: message('UNREACHABLE_FINAL', { name: node[keys.label] || idOf(node) }),\n\t\t\t})\n\t\t}\n\t})\n\n\tconst reachesFinal = new Set(finals.map(idOf))\n\tconst back = finals.map(idOf)\n\twhile (back.length > 0) {\n\t\treverse.get(back.shift()).forEach((previous) => {\n\t\t\tif (!reachesFinal.has(previous)) {\n\t\t\t\treachesFinal.add(previous)\n\t\t\t\tback.push(previous)\n\t\t\t}\n\t\t})\n\t}\n\n\tconst WHITE = 0\n\tconst GREY = 1\n\tconst BLACK = 2\n\tconst colour = new Map(nodes.map((node) => [idOf(node), WHITE]))\n\tconst stack = []\n\tconst reported = new Set()\n\tconst visit = (id) => {\n\t\tcolour.set(id, GREY)\n\t\tstack.push(id)\n\t\tforward.get(id).forEach((next) => {\n\t\t\tif (colour.get(next) === GREY) {\n\t\t\t\tconst cycle = stack.slice(stack.indexOf(next))\n\t\t\t\tconst cycleKey = [...cycle].sort().join(',')\n\t\t\t\tif (!reported.has(cycleKey) && !cycle.some((member) => reachesFinal.has(member))) {\n\t\t\t\t\treported.add(cycleKey)\n\t\t\t\t\tissues.push({\n\t\t\t\t\t\ttype: 'warning',\n\t\t\t\t\t\tcode: STATE_MACHINE_RULES.CYCLE_NO_EXIT,\n\t\t\t\t\t\tmessage: message('CYCLE_NO_EXIT', { names: cycle.map(nameOf).join(' → ') }),\n\t\t\t\t\t})\n\t\t\t\t}\n\t\t\t} else if (colour.get(next) === WHITE) {\n\t\t\t\tvisit(next)\n\t\t\t}\n\t\t})\n\t\tstack.pop()\n\t\tcolour.set(id, BLACK)\n\t}\n\tnodes.forEach((node) => {\n\t\tif (colour.get(idOf(node)) === WHITE) {\n\t\t\tvisit(idOf(node))\n\t\t}\n\t})\n\n\treturn issues\n}\n"],"names":["t"],"mappings":"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"}

package/dist/esm/utils/widgetDispatch.js

@@ -48,10 +48,12 @@ import { canonicalWidgetType } from './widgetTypeAliases.js';
  * header (link, note) come from the host, and it has no Add.
  * `parties` draws a record's parties by role and `map` a bare Leaflet map:
  * on a card surface both need the titled wrapper, and neither has an Add.
+ * `object-translations` is a bare per-language editor that takes the titled
+ * wrapper and has no Add.
  *
  * @type {string[]}
  */
-const CONTENT_ONLY_TYPES = Object.freeze(['object-list', 'table', 'files', 'flow-runs', 'tasks', 'events', 'facts', 'linked', 'field-list', 'record-list', 'parties', 'map', 'settings-form', 'switch-rows', 'radio-cards', 'chips-field', 'toggle-table', 'choice-picker', 'checklist']);
+const CONTENT_ONLY_TYPES = Object.freeze(['object-list', 'table', 'files', 'flow-runs', 'tasks', 'events', 'facts', 'linked', 'field-list', 'record-list', 'parties', 'map', 'settings-form', 'switch-rows', 'radio-cards', 'chips-field', 'toggle-table', 'choice-picker', 'checklist', 'object-translations']);
 
 /**
  * The stored content/config blob for a widget definition.

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

@@ -1 +1 @@
-{"version":3,"file":"widgetDispatch.js","sources":["../../../src/utils/widgetDispatch.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * widgetDispatch — how a detail-page widget definition picks its renderer.\n *\n * These predicates used to live as methods on `CnDetailPage`, each one calling\n * `findWidget(item)` first. That was fine while the detail grid was the only\n * surface rendering a widget definition. `CnTabsWidget` is a second one: it\n * renders the SAME definitions with no card chrome, because the tab strip owns\n * the title and the Actions menu instead.\n *\n * Two copies of \"is this a card widget?\" is exactly the kind of thing that\n * drifts. One copy grows a type, the other does not, and the symptom is a\n * widget that renders correctly on the page and blank inside a tab, with\n * nothing in the console either way. So the decisions live here as pure\n * functions over a widget DEFINITION, and both surfaces import them.\n *\n * The functions take the resolved definition, not a layout item. Resolving an\n * item to a definition needs the surface's own widget list, which is the one\n * part that genuinely differs between the two.\n *\n * @module utils/widgetDispatch\n */\n\nimport { BUILT_IN_WIDGETS } from '../components/CnWidgetGrid/builtInWidgets.js'\nimport { getWidgetTypeEntry } from '../components/CnWidgetGrid/dashboardWidgetRegistry.js'\nimport { canonicalWidgetType } from './widgetTypeAliases.js'\n\n/**\n * Content-only catalog widgets: bare renderers with no chrome of their own.\n * On a card surface they need the titled wrapper; inside a tab panel the strip\n * already supplies the title, so they render bare.\n *\n * `flow-runs` belongs here for the same reason the lists do: it renders a bare\n * row list, so without the wrapper it appeared on the detail page as loose text\n * with no title and no card, which ADR-062 rule 5 forbids (\"every body widget\n * has card chrome and its manifest title\"). It is NOT in the Add-action list,\n * because a run is started by a flow, never by a person clicking Add.\n * `tasks` follows for the same two reasons: a bare row list, and a task is\n * created by a flow, never by a person clicking Add.\n * `facts` is a bare list of label/value rows about one object: on a side\n * card it needs the same titled wrapper, and there is nothing to Add.\n * `field-list` draws rows of one object field and carries its own add form,\n * so it takes the titled wrapper and not the catalog Add action.\n * `record-list` draws bare rows of another schema's objects; the card and its\n * header (link, note) come from the host, and it has no Add.\n * `parties` draws a record's parties by role and `map` a bare Leaflet map:\n * on a card surface both need the titled wrapper, and neither has an Add.\n *\n * @type {string[]}\n */\nexport const CONTENT_ONLY_TYPES = Object.freeze(['object-list', 'table', 'files', 'flow-runs', 'tasks', 'events', 'facts', 'linked', 'field-list', 'record-list', 'parties', 'map', 'settings-form', 'switch-rows', 'radio-cards', 'chips-field', 'toggle-table', 'choice-picker', 'checklist'])\n\n/**\n * The stored content/config blob for a widget definition.\n *\n * @param {object} def The widget definition.\n * @return {object} The definition's `content`, or an empty object.\n */\nexport function widgetContentOf(def) {\n\treturn (def && def.content && typeof def.content === 'object') ? def.content : {}\n}\n\n/**\n * Whether the definition is the schema-driven `data` widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'data'`.\n */\nexport function isDataWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'data'\n}\n\n/**\n * Whether the definition is the schema-driven `related` widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'related'`.\n */\nexport function isRelatedWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'related'\n}\n\n/**\n * Whether the definition is the `object-geo` widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'object-geo'`.\n */\nexport function isGeoWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'object-geo'\n}\n\n/**\n * Whether the definition names a registered integration leaf.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'integration'` with an `integrationId`.\n */\nexport function isIntegrationWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'integration' && typeof def.integrationId === 'string'\n}\n\n/**\n * Whether the definition is a content-only catalog widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true when the type is in {@link CONTENT_ONLY_TYPES}.\n */\nexport function isContentOnlyWidgetDef(def) {\n\treturn Boolean(def) && CONTENT_ONLY_TYPES.includes(def.type)\n}\n\n/**\n * Whether the definition is a registry \"card\" widget: a self-contained KPI,\n * gauge or delta tile that headlines itself (registry entry `card: true`).\n *\n * @param {object} def The widget definition.\n * @return {boolean} true when the registry entry declares `card`.\n */\nexport function isCardWidgetDef(def) {\n\tif (!def || !def.type) {\n\t\treturn false\n\t}\n\tconst entry = getWidgetTypeEntry(def.type)\n\treturn Boolean(entry && entry.card === true)\n}\n\n/**\n * Resolve the registered RENDERER for a content-driven catalog widget type.\n *\n * Integration widgets resolve separately, and `data` needs object context the\n * caller supplies, so both are excluded from this generic fallback.\n *\n * Resolution order is consumer registry, then the dashboard catalog, then\n * `BUILT_IN_WIDGETS`. Those last two were near-disjoint vocabularies until they\n * were unified here: the dashboard catalog held chart / map / object-list /\n * related / stats-block / table, `BUILT_IN_WIDGETS` held audit-trail / banner /\n * card-grid / data / divider / form-renderer / header / integration /\n * map-viewer / metadata / nav-card-grid / object-geo / related / text, and only\n * `related` was in both. A widget authored against one was invisible to the\n * other, and the surface rendered nothing while saying nothing about why. On\n * hrmq that was 101 of 236 detail widgets.\n *\n * With `typeAsWritten`, a type registered in its own right wins over its\n * alias, as on CnDashboardPage: there `object-table` is the host adapter that\n * reads `content.source`, not the `table` widget its alias names. A detail\n * page keeps the alias first, as its manifests were written against it.\n *\n * @param {object} def The widget definition.\n * @param {object} [cnRegistry] The consumer's component registry, if any.\n * @param {{typeAsWritten?: boolean}} [options] Resolution options.\n * @return {object|null} The renderer component, or null.\n */\nexport function resolveRegistryRenderer(def, cnRegistry = {}, options = {}) {\n\tif (!def || !def.type || def.type === 'integration' || def.type === 'data') {\n\t\treturn null\n\t}\n\t// Consumer registry FIRST — the order REQ-MVR-005 mandates (\"Custom widget\n\t// overrides built-in\"), and the order CnWidgetGrid already uses.\n\tconst consumer = (cnRegistry || {})[def.type]\n\tif (consumer) {\n\t\treturn consumer.component ?? consumer\n\t}\n\tconst entry = (options.typeAsWritten === true && getWidgetTypeEntry(def.type)) || getWidgetTypeEntry(canonicalWidgetType(def.type))\n\tif (entry && entry.renderer) {\n\t\treturn entry.renderer\n\t}\n\treturn BUILT_IN_WIDGETS[canonicalWidgetType(def.type)] || BUILT_IN_WIDGETS[def.type] || null\n}\n\n/**\n * The effective title for a widget definition.\n *\n * A title-owning type (registry `ownsTitle`, e.g. `related`) keeps its editable\n * title in `content.title`, and that MUST win over the chrome `def.title`.\n * Otherwise a non-empty seed title permanently shadows the user's edit and the\n * title can never be changed. Without a `content.title` it falls back to\n * `def.title`. Every other type reads `def.title` first.\n *\n * @param {object} def The widget definition.\n * @return {string|undefined} The title, or undefined to let the widget default.\n */\nexport function widgetTitleOf(def) {\n\tif (!def) {\n\t\treturn undefined\n\t}\n\tconst content = widgetContentOf(def)\n\tconst entry = getWidgetTypeEntry(def.type)\n\tif (entry && entry.ownsTitle) {\n\t\t// A manifest that never set content.title keeps its def.title.\n\t\tif (typeof content.title !== 'string') {\n\t\t\treturn def.title || undefined\n\t\t}\n\t\treturn content.title || undefined\n\t}\n\treturn def.title || content.title || undefined\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;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,kBAAkB,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,aAAa,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,aAAa,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,WAAW,CAAC,EAAC;AAChS;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,eAAe,CAAC,GAAG,EAAE;AACrC,CAAC,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,IAAI,GAAG,CAAC,OAAO,GAAG,EAAE;AAClF,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,eAAe,CAAC,GAAG,EAAE;AACrC,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM;AAC3C,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,kBAAkB,CAAC,GAAG,EAAE;AACxC,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;AAC9C,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,cAAc,CAAC,GAAG,EAAE;AACpC,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,YAAY;AACjD,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,sBAAsB,CAAC,GAAG,EAAE;AAC5C,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,IAAI,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ;AAC3F,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,sBAAsB,CAAC,GAAG,EAAE;AAC5C,CAAC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,kBAAkB,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;AAC7D,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,eAAe,CAAC,GAAG,EAAE;AACrC,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE;AACxB,EAAE,OAAO,KAAK;AACd,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAC;AAC3C,CAAC,OAAO,OAAO,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC7C,CAAC;AACD;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,uBAAuB,CAAC,GAAG,EAAE,UAAU,GAAG,EAAE,EAAE,OAAO,GAAG,EAAE,EAAE;AAC5E,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,KAAK,aAAa,IAAI,GAAG,CAAC,IAAI,KAAK,MAAM,EAAE;AAC7E,EAAE,OAAO,IAAI;AACb,EAAE;AACF;AACA;AACA,CAAC,MAAM,QAAQ,GAAG,CAAC,UAAU,IAAI,EAAE,EAAE,GAAG,CAAC,IAAI,EAAC;AAC9C,CAAC,IAAI,QAAQ,EAAE;AACf,EAAE,OAAO,QAAQ,CAAC,SAAS,IAAI,QAAQ;AACvC,EAAE;AACF,CAAC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,aAAa,KAAK,IAAI,IAAI,kBAAkB,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,kBAAkB,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAC;AACpI,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,QAAQ,EAAE;AAC9B,EAAE,OAAO,KAAK,CAAC,QAAQ;AACvB,EAAE;AACF,CAAC,OAAO,gBAAgB,CAAC,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,gBAAgB,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI;AAC7F,CAAC;AACD;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACO,SAAS,aAAa,CAAC,GAAG,EAAE;AACnC,CAAC,IAAI,CAAC,GAAG,EAAE;AACX,EAAE,OAAO,SAAS;AAClB,EAAE;AACF,CAAC,MAAM,OAAO,GAAG,eAAe,CAAC,GAAG,EAAC;AACrC,CAAC,MAAM,KAAK,GAAG,kBAAkB,CAAC,GAAG,CAAC,IAAI,EAAC;AAC3C,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,SAAS,EAAE;AAC/B;AACA,EAAE,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,EAAE;AACzC,GAAG,OAAO,GAAG,CAAC,KAAK,IAAI,SAAS;AAChC,GAAG;AACH,EAAE,OAAO,OAAO,CAAC,KAAK,IAAI,SAAS;AACnC,EAAE;AACF,CAAC,OAAO,GAAG,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,IAAI,SAAS;AAC/C;;;;"}
+{"version":3,"file":"widgetDispatch.js","sources":["../../../src/utils/widgetDispatch.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n *\n * widgetDispatch — how a detail-page widget definition picks its renderer.\n *\n * These predicates used to live as methods on `CnDetailPage`, each one calling\n * `findWidget(item)` first. That was fine while the detail grid was the only\n * surface rendering a widget definition. `CnTabsWidget` is a second one: it\n * renders the SAME definitions with no card chrome, because the tab strip owns\n * the title and the Actions menu instead.\n *\n * Two copies of \"is this a card widget?\" is exactly the kind of thing that\n * drifts. One copy grows a type, the other does not, and the symptom is a\n * widget that renders correctly on the page and blank inside a tab, with\n * nothing in the console either way. So the decisions live here as pure\n * functions over a widget DEFINITION, and both surfaces import them.\n *\n * The functions take the resolved definition, not a layout item. Resolving an\n * item to a definition needs the surface's own widget list, which is the one\n * part that genuinely differs between the two.\n *\n * @module utils/widgetDispatch\n */\n\nimport { BUILT_IN_WIDGETS } from '../components/CnWidgetGrid/builtInWidgets.js'\nimport { getWidgetTypeEntry } from '../components/CnWidgetGrid/dashboardWidgetRegistry.js'\nimport { canonicalWidgetType } from './widgetTypeAliases.js'\n\n/**\n * Content-only catalog widgets: bare renderers with no chrome of their own.\n * On a card surface they need the titled wrapper; inside a tab panel the strip\n * already supplies the title, so they render bare.\n *\n * `flow-runs` belongs here for the same reason the lists do: it renders a bare\n * row list, so without the wrapper it appeared on the detail page as loose text\n * with no title and no card, which ADR-062 rule 5 forbids (\"every body widget\n * has card chrome and its manifest title\"). It is NOT in the Add-action list,\n * because a run is started by a flow, never by a person clicking Add.\n * `tasks` follows for the same two reasons: a bare row list, and a task is\n * created by a flow, never by a person clicking Add.\n * `facts` is a bare list of label/value rows about one object: on a side\n * card it needs the same titled wrapper, and there is nothing to Add.\n * `field-list` draws rows of one object field and carries its own add form,\n * so it takes the titled wrapper and not the catalog Add action.\n * `record-list` draws bare rows of another schema's objects; the card and its\n * header (link, note) come from the host, and it has no Add.\n * `parties` draws a record's parties by role and `map` a bare Leaflet map:\n * on a card surface both need the titled wrapper, and neither has an Add.\n * `object-translations` is a bare per-language editor that takes the titled\n * wrapper and has no Add.\n *\n * @type {string[]}\n */\nexport const CONTENT_ONLY_TYPES = Object.freeze(['object-list', 'table', 'files', 'flow-runs', 'tasks', 'events', 'facts', 'linked', 'field-list', 'record-list', 'parties', 'map', 'settings-form', 'switch-rows', 'radio-cards', 'chips-field', 'toggle-table', 'choice-picker', 'checklist', 'object-translations'])\n\n/**\n * The stored content/config blob for a widget definition.\n *\n * @param {object} def The widget definition.\n * @return {object} The definition's `content`, or an empty object.\n */\nexport function widgetContentOf(def) {\n\treturn (def && def.content && typeof def.content === 'object') ? def.content : {}\n}\n\n/**\n * Whether the definition is the schema-driven `data` widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'data'`.\n */\nexport function isDataWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'data'\n}\n\n/**\n * Whether the definition is the schema-driven `related` widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'related'`.\n */\nexport function isRelatedWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'related'\n}\n\n/**\n * Whether the definition is the `object-geo` widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'object-geo'`.\n */\nexport function isGeoWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'object-geo'\n}\n\n/**\n * Whether the definition names a registered integration leaf.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true for `type: 'integration'` with an `integrationId`.\n */\nexport function isIntegrationWidgetDef(def) {\n\treturn Boolean(def) && def.type === 'integration' && typeof def.integrationId === 'string'\n}\n\n/**\n * Whether the definition is a content-only catalog widget.\n *\n * @param {object} def The widget definition.\n * @return {boolean} true when the type is in {@link CONTENT_ONLY_TYPES}.\n */\nexport function isContentOnlyWidgetDef(def) {\n\treturn Boolean(def) && CONTENT_ONLY_TYPES.includes(def.type)\n}\n\n/**\n * Whether the definition is a registry \"card\" widget: a self-contained KPI,\n * gauge or delta tile that headlines itself (registry entry `card: true`).\n *\n * @param {object} def The widget definition.\n * @return {boolean} true when the registry entry declares `card`.\n */\nexport function isCardWidgetDef(def) {\n\tif (!def || !def.type) {\n\t\treturn false\n\t}\n\tconst entry = getWidgetTypeEntry(def.type)\n\treturn Boolean(entry && entry.card === true)\n}\n\n/**\n * Resolve the registered RENDERER for a content-driven catalog widget type.\n *\n * Integration widgets resolve separately, and `data` needs object context the\n * caller supplies, so both are excluded from this generic fallback.\n *\n * Resolution order is consumer registry, then the dashboard catalog, then\n * `BUILT_IN_WIDGETS`. Those last two were near-disjoint vocabularies until they\n * were unified here: the dashboard catalog held chart / map / object-list /\n * related / stats-block / table, `BUILT_IN_WIDGETS` held audit-trail / banner /\n * card-grid / data / divider / form-renderer / header / integration /\n * map-viewer / metadata / nav-card-grid / object-geo / related / text, and only\n * `related` was in both. A widget authored against one was invisible to the\n * other, and the surface rendered nothing while saying nothing about why. On\n * hrmq that was 101 of 236 detail widgets.\n *\n * With `typeAsWritten`, a type registered in its own right wins over its\n * alias, as on CnDashboardPage: there `object-table` is the host adapter that\n * reads `content.source`, not the `table` widget its alias names. A detail\n * page keeps the alias first, as its manifests were written against it.\n *\n * @param {object} def The widget definition.\n * @param {object} [cnRegistry] The consumer's component registry, if any.\n * @param {{typeAsWritten?: boolean}} [options] Resolution options.\n * @return {object|null} The renderer component, or null.\n */\nexport function resolveRegistryRenderer(def, cnRegistry = {}, options = {}) {\n\tif (!def || !def.type || def.type === 'integration' || def.type === 'data') {\n\t\treturn null\n\t}\n\t// Consumer registry FIRST — the order REQ-MVR-005 mandates (\"Custom widget\n\t// overrides built-in\"), and the order CnWidgetGrid already uses.\n\tconst consumer = (cnRegistry || {})[def.type]\n\tif (consumer) {\n\t\treturn consumer.component ?? consumer\n\t}\n\tconst entry = (options.typeAsWritten === true && getWidgetTypeEntry(def.type)) || getWidgetTypeEntry(canonicalWidgetType(def.type))\n\tif (entry && entry.renderer) {\n\t\treturn entry.renderer\n\t}\n\treturn BUILT_IN_WIDGETS[canonicalWidgetType(def.type)] || BUILT_IN_WIDGETS[def.type] || null\n}\n\n/**\n * The effective title for a widget definition.\n *\n * A title-owning type (registry `ownsTitle`, e.g. `related`) keeps its editable\n * title in `content.title`, and that MUST win over the chrome `def.title`.\n * Otherwise a non-empty seed title permanently shadows the user's edit and the\n * title can never be changed. Without a `content.title` it falls back to\n * `def.title`. Every other type reads `def.title` first.\n *\n * @param {object} def The widget definition.\n * @return {string|undefined} The title, or undefined to let the widget default.\n */\nexport function widgetTitleOf(def) {\n\tif (!def) {\n\t\treturn undefined\n\t}\n\tconst content = widgetContentOf(def)\n\tconst entry = getWidgetTypeEntry(def.type)\n\tif (entry && entry.ownsTitle) {\n\t\t// A manifest that never set content.title keeps its def.title.\n\t\tif (typeof content.title !== 'string') {\n\t\t\treturn def.title || undefined\n\t\t}\n\t\treturn content.title || undefined\n\t}\n\treturn def.title || content.title || undefined\n}\n"],"names":[],"mappings":"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"}