@conduction/nextcloud-vue 2.138.0 → 2.140.0

package/dist/esm/components/CnChartWidget/CnChartWidget.vue2.js

@@ -1,5 +1,6 @@
 import { subscribe, unsubscribe } from '@nextcloud/event-bus';
 import { translate, getLanguage } from '@nextcloud/l10n';
+import { NcNoteCard } from '@nextcloud/vue';
 import { ref, inject, markRaw } from 'vue';
 import m from '../../node_modules/vue3-apexcharts/dist/vue3-apexcharts.js';
 import { useDataSource } from '../../composables/useDataSource.js';
@@ -251,7 +252,7 @@ function formatterFor(vf) {
 var script = {
 	name: 'CnChartWidget',
 
-	components: { CnEndpointNotice: __sfc_main },
+	components: { CnEndpointNotice: __sfc_main, NcNoteCard },
 
 	inject: {
 		/**
@@ -313,6 +314,24 @@ var script = {
 			default: null,
 		},
 
+		/**
+		 * A toned note card under the chart whose words carry values from the
+		 * page record: `{ lead?, text?, values?, labels?, tone? }`. `lead`
+		 * (bold) and `text` go through the host's translate, then each
+		 * `{name}` is filled from `values[name]`, a literal or a token such as
+		 * `@object.recommendedIntervention`. `labels[name]` turns a key into
+		 * words: `"rows"`, `"columns"` or `"values"` read the matrix's
+		 * cellSource label maps, an object is its own map. `tone` is info
+		 * (default), success, warning or error. Hidden while a value is
+		 * missing, so a half-filled sentence never shows.
+		 *
+		 * @spec openspec/changes/chart-notice/specs/chart-notice/spec.md#requirement-a-chart-can-carry-a-notice-with-record-values
+		 */
+		notice: {
+			type: Object,
+			default: null,
+		},
+
 		/**
 		 * A line under the chart ("Klik een balk om de zaken te zien"),
 		 * through the host's translate: under the rows of a `bar-list` or
@@ -1447,6 +1466,38 @@ var script = {
 			}
 		},
 
+		/**
+		 * The notice's bold lead, text and note-card type, values filled in;
+		 * null when there is none or a value is missing.
+		 *
+		 * @return {{lead: string, text: string, type: string}|null} The notice.
+		 * @spec openspec/changes/chart-notice/specs/chart-notice/spec.md#requirement-a-chart-can-carry-a-notice-with-record-values
+		 */
+		noticeParts() {
+			const def = this.notice;
+			if (!def || typeof def !== 'object' || (!def.lead && !def.text)) {
+				return null
+			}
+			const declared = def.values && typeof def.values === 'object' ? def.values : {};
+			const resolved = resolveFilterTokens(declared, this.chartTokenCtx());
+			const source = this.cellSource && typeof this.cellSource === 'object' ? this.cellSource : {};
+			const maps = { rows: source.rowLabels, columns: source.columnLabels, values: source.valueLabels };
+			const words = {};
+			for (const name of Object.keys(declared)) {
+				const raw = resolved[name];
+				if (raw === null || raw === undefined || raw === '' || (typeof raw === 'string' && raw.charAt(0) === '@')) {
+					return null
+				}
+				const ref = def.labels && def.labels[name];
+				const map = typeof ref === 'string' ? maps[ref] : ref;
+				const label = map && typeof map === 'object' && typeof map[String(raw)] === 'string' ? map[String(raw)] : null;
+				words[name] = label ? this.hostTranslate(label) : String(raw);
+			}
+			const fill = (key) => (key ? this.hostTranslate(key).replace(/\{(\w+)\}/g, (match, name) => (name in words ? words[name] : match)) : '');
+			const type = ['info', 'success', 'warning', 'error'].includes(def.tone) ? def.tone : 'info';
+			return { lead: fill(def.lead), text: fill(def.text), type }
+		},
+
 		/**
 		 * The matrix cell of the record (`highlight: { row, column }`, tokens
 		 * such as `@object.behaviour` resolved), as row and column indexes. A