@conduction/nextcloud-vue 2.77.0 → 2.79.0

package/src/css/table.css

@@ -230,6 +230,34 @@
 	min-width: 0;
 }
 
+/* Fit to the container (CnDataTable's `fitWidth`, on in CnWidgetObjectTable).
+
+   In a narrow tile the auto layout made the table as wide as its one-line
+   cells, so it ran past the tile and clipped the trailing column (a date).
+   Here every column but one takes the width of its content (`width: 1%` asks
+   for as little as the content allows), and the grow column takes what is
+   left. `max-width: 0` is what lets that column go below its content's width:
+   the table no longer counts its text, so the text is cut with an ellipsis
+   instead of widening the table. The full value stays in the cell's tooltip. */
+.cn-data-table--fit {
+	width: 100%;
+}
+
+.cn-data-table--fit th,
+.cn-data-table--fit td {
+	width: 1%;
+}
+
+.cn-data-table--fit th.cn-table-col--grow,
+.cn-data-table--fit td.cn-table-col--grow {
+	width: auto;
+	min-width: 0;
+	max-width: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
 .cn-data-table th {
 	background: var(--color-background-dark);
 	font-weight: 500;
@@ -578,6 +606,15 @@
 	color: var(--color-text-maxcontrast);
 }
 
+/* The empty row holds a sentence (the empty text, or why a lens cannot
+   answer), not a cell value: it wraps instead of being cut to one line. The
+   selector carries the table class so it outranks the one-line cell rule. */
+.cn-data-table .cn-table-empty td {
+	max-width: none;
+	white-space: normal;
+	overflow-wrap: anywhere;
+}
+
 /* ========================================
    Backwards compatibility aliases
    (legacy OpenRegister CSS class names)

package/src/index.js

@@ -338,6 +338,10 @@ export {
 // @deprecated Use `CnBuildiqEditButton`.
 export { CnOpenBuildEditButton } from './components/index.js'
 
+// A CnFilesBrowser data source that reads an OpenRegister object's folder
+// through OpenRegister's files API (openspec: files-browser-openregister-source).
+export { createOpenRegisterSource } from './components/index.js'
+
 // Workplace dashboard primitives (openspec: workplace-dashboard-primitives):
 // the week strip and stacked bar widgets with their forms, the segmented
 // control, and the brand stripe.

package/src/schemas/app-manifest-v2.schema.json

@@ -3,7 +3,7 @@
 	"$id": "https://raw.githubusercontent.com/ConductionNL/nextcloud-vue/main/src/schemas/app-manifest-v2.schema.json",
 	"title": "Conduction App Manifest v2",
 	"description": "v2 schema for the JSON-driven page and navigation manifest consumed by @conduction/nextcloud-vue. Introduces a uniform widgets[] array on every page type with a per-slot grid coordinate system, a typed actions[] discriminator, and the required $schema field for version detection. v1 manifests continue to validate against app-manifest.schema.json (unchanged).",
-	"version": "2.75.0",
+	"version": "2.79.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -1094,7 +1094,7 @@
 						"pillColors": {
 							"type": "object",
 							"description": "Pill value to badge variant. A value without an entry takes the default variant.",
-							"additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info"] }
+							"additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] }
 						},
 						"due": { "type": "string", "description": "The date field of the footer's due text, marked by `dueRule`." },
 						"owner": { "type": "string", "description": "The field of the owner shown as an avatar (initials) at the footer's end." }
@@ -1143,7 +1143,7 @@
 				"colorMap": {
 					"type": "object",
 					"description": "Raw value to badge variant. Keys are matched ignoring case.",
-					"additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info"] }
+					"additionalProperties": { "type": "string", "enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"] }
 				},
 				"labels": {
 					"type": "object",
@@ -1152,7 +1152,7 @@
 				},
 				"variant": {
 					"type": "string",
-					"enum": ["default", "primary", "success", "warning", "error", "info"],
+					"enum": ["default", "primary", "success", "warning", "error", "info", "purple", "teal"],
 					"default": "default",
 					"description": "Badge variant for a value `colorMap` does not name."
 				}
@@ -3586,7 +3586,7 @@
 						},
 						"columns": {
 							"type": "array",
-							"description": "Table columns (for type='index' and type='logs'). Items may be strings (legacy shorthand) or column objects ({ key, label, sortable?, width?, formatter?, formatterOptions?, widget?, widgetProps?, format?, aggregate? }). `formatter` resolves against cnFormatters (built-ins incl. currency / conditionalPhrase — configured via `formatterOptions`); `widget` resolves against cnCellWidgets (built-ins incl. badge / fkResolve / link / avatar / date).",
+							"description": "Table columns (for type='index' and type='logs'). Items may be strings (legacy shorthand) or column objects ({ key, label, sortable?, width?, formatter?, formatterOptions?, widget?, widgetProps?, format?, aggregate?, colorMap? }). `colorMap` maps an enum column's raw values to a pill tone (default, primary, success, warning, error, info, purple, teal) and wins over the schema property's own `colorMap` / `x-color-map`. `formatter` resolves against cnFormatters (built-ins incl. currency / conditionalPhrase — configured via `formatterOptions`); `widget` resolves against cnCellWidgets (built-ins incl. badge / fkResolve / link / avatar / date).",
 							"items": {
 								"oneOf": [
 									{ "type": "string" },
@@ -4004,6 +4004,40 @@
 							"default": [],
 							"description": "type='dashboard': widget ids drawn as a KPI row above the grid, in the listed order, in an auto-fit grid (`repeat(auto-fit, minmax(200px, 1fr))`, gap 16). The named widgets are not GridStack items, so they do not reflow with the grid and are not part of the emitted layout; an id that names no widget is skipped with a development warning (screens-dashboard-parity). Maps to CnDashboardPage `kpiRow`. `dateRange.control` also accepts \"segmented\": the presets as one compact segmented group under the header."
 						},
+						"greeting": {
+							"oneOf": [
+								{ "type": "boolean" },
+								{ "type": "string", "enum": ["first", "full"] }
+							],
+							"default": false,
+							"description": "type='dashboard': greet the reader in the header subtitle. `true` or \"first\" writes \"Good afternoon, Pieter · Monday 5 October 2026\", \"full\" uses the whole display name; the page `description` follows after another middle dot (screens-dashboard-greeting-header). Maps to CnDashboardPage `greeting`."
+						},
+						"viewLinks": {
+							"type": "array",
+							"default": [],
+							"description": "type='dashboard': links drawn as small pills on the switch row under the header, right of the view switch (screens-dashboard-greeting-header). `route` is a route name or a `{ name, params, query }` location, `href` a plain URL; `label` is an i18n key. An entry without a label or a target is skipped. Maps to CnDashboardPage `viewLinks`.",
+							"items": {
+								"type": "object",
+								"required": ["label"],
+								"additionalProperties": false,
+								"properties": {
+									"label": { "type": "string", "minLength": 1 },
+									"icon": { "type": "string", "minLength": 1 },
+									"route": {
+										"oneOf": [
+											{ "type": "string", "minLength": 1 },
+											{ "type": "object", "required": ["name"], "properties": { "name": { "type": "string", "minLength": 1 }, "params": { "type": "object" }, "query": { "type": "object" } } }
+										]
+									},
+									"href": { "type": "string", "minLength": 1 }
+								}
+							}
+						},
+						"showActionsMenu": {
+							"type": "boolean",
+							"default": true,
+							"description": "type='dashboard': `false` removes the page Actions menu from the header, for a board page whose header carries only the buildiq square and the primary (screens-dashboard-greeting-header). Maps to CnDashboardPage `showActionsMenu`."
+						},
 						"gridFloat": {
 							"type": "boolean",
 							"default": true,
@@ -4038,6 +4072,11 @@
 							"minLength": 1,
 							"description": "type='index', board look: free text after the footer's count, e.g. \"click a column header to sort\" (screens-index-list-parity). Maps to CnIndexPage `footerNote`."
 						},
+						"searchPlaceholder": {
+							"type": "string",
+							"minLength": 1,
+							"description": "type='index': the placeholder (and accessible name) of the list's search field, e.g. \"Search by case, number or requester\". Run through the app's translate, so an English key with a Dutch catalogue entry reads Dutch. Absent: the library's \"Search…\" (screens-index-toolbar-parity). Maps to CnIndexPage `searchPlaceholder`."
+						},
 						"bulkHint": {
 							"type": "string",
 							"minLength": 1,
@@ -4065,6 +4104,12 @@
 								}
 							}
 						},
+						"rowTitle": {
+							"type": "string",
+							"enum": ["link", "plain"],
+							"default": "link",
+							"description": "type='index' (screens-table-rows-parity): how the board look draws the table's title column. `link` (the default) is the 15px weight 600 underlined title of the DqZaken board; `plain` is the 15px bold title without an underline over a 13px muted secondary line, as the PqTickets and OcPublicaties boards draw it. The row stays clickable either way. The Nextcloud look ignores it. Maps to CnIndexPage `rowTitle`."
+						},
 						"showTypeEyebrow": {
 							"type": "boolean",
 							"default": true,

package/src/utils/badgeVariants.js

@@ -0,0 +1,29 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * badgeVariants: the colour variants a CnStatusBadge (a status pill) may take.
+ *
+ * The first six follow the Nextcloud colour roles. `purple` and `teal` are the
+ * two tones the drawn boards use for a status that has no Nextcloud role, such
+ * as "In behandeling" (work in progress) and "Omgezet naar een zaak" (handed
+ * on). One list, so the badge, the board card pill and the manifest schema
+ * accept the same names.
+ *
+ * @module utils/badgeVariants
+ * @spec openspec/changes/screens-cell-pill-parity/specs/cell-pill-tones/spec.md#requirement-a-status-pill-has-eight-tones
+ */
+
+/** Every variant a status pill accepts, in the order the docs list them. */
+export const BADGE_VARIANTS = Object.freeze(['default', 'primary', 'success', 'warning', 'error', 'info', 'purple', 'teal'])
+
+/**
+ * Whether a value names a badge variant.
+ *
+ * @param {unknown} variant The candidate variant.
+ * @return {boolean} True for one of `BADGE_VARIANTS`.
+ * @spec openspec/changes/screens-cell-pill-parity/specs/cell-pill-tones/spec.md#requirement-a-status-pill-has-eight-tones
+ */
+export function isBadgeVariant(variant) {
+	return typeof variant === 'string' && BADGE_VARIANTS.includes(variant)
+}

package/src/utils/boardDate.js

@@ -0,0 +1,189 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * boardDate: the two short time readings the drawn boards put in a table cell.
+ *
+ * - A date ("5 okt", "30 okt", "14 feb 2024"): day and short month in the
+ *   user's language, the year only when it is not the current year.
+ * - An age ("4 uur", "1 dag", "3 dagen"): how long something has been
+ *   waiting, in hours under a day and in whole calendar days after that.
+ *
+ * Both read the Nextcloud user LANGUAGE for the month and unit names. A
+ * Nextcloud account keeps its locale (date order) apart from its language,
+ * and a Dutch reader whose locale was left at the en_US default saw
+ * "Feb 14, 2024": the language decides the words, so it decides here, and the
+ * locale is only used when it is a region of that same language.
+ *
+ * @module utils/boardDate
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md
+ */
+
+import { getCanonicalLocale, getLanguage, translatePlural as n } from '@nextcloud/l10n'
+import { parseDateValue } from './dateVariant.js'
+import { compareVisibleWhen } from './visibleWhen.js'
+
+const MS_PER_HOUR = 3600000
+const MS_PER_DAY = 86400000
+
+/** Variants an age rule may name. `danger` is accepted as an alias of `error`. */
+export const AGE_VARIANTS = Object.freeze(['default', 'success', 'warning', 'error'])
+
+/**
+ * Read a language or locale tag from an @nextcloud/l10n getter, which throws
+ * when Nextcloud has not set one (outside a Nextcloud page, in a test).
+ *
+ * @param {() => string} getter `getLanguage` or `getCanonicalLocale`.
+ * @return {string} The tag with `-` separators, or ''.
+ */
+function readTag(getter) {
+	try {
+		return String(getter() || '').replace(/_/g, '-')
+	} catch {
+		return ''
+	}
+}
+
+/**
+ * The BCP 47 tag the board dates are written in: the user's locale when it is
+ * a region of the user's language (`nl-BE` for language `nl`), else the
+ * language itself.
+ *
+ * @return {string|undefined} The tag, or undefined to let Intl choose.
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md#requirement-a-board-date-cell-reads-day-and-short-month-in-the-user-language
+ */
+export function boardDateLocale() {
+	const language = readTag(getLanguage)
+	const locale = readTag(getCanonicalLocale)
+	const base = (tag) => tag.split('-')[0].toLowerCase()
+	if (language && locale && base(language) === base(locale)) {
+		return locale
+	}
+	return language || locale || undefined
+}
+
+/**
+ * A date in the board's short form: "5 okt", or "14 feb 2024" outside the
+ * current year.
+ *
+ * @param {unknown} value A Date, a timestamp or an ISO string.
+ * @param {Date} [now] The reference moment (defaults to the current time).
+ * @param {string} [locale] BCP 47 tag (defaults to `boardDateLocale()`).
+ * @return {string} The short date, or '' when the value is not a date.
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md#requirement-a-board-date-cell-reads-day-and-short-month-in-the-user-language
+ */
+export function formatBoardDate(value, now = new Date(), locale = boardDateLocale()) {
+	const date = parseDateValue(value)
+	if (date === null) {
+		return ''
+	}
+	const options = { day: 'numeric', month: 'short' }
+	if (date.getFullYear() !== now.getFullYear()) {
+		options.year = 'numeric'
+	}
+	try {
+		return new Intl.DateTimeFormat(locale, options).format(date)
+	} catch {
+		return new Intl.DateTimeFormat(undefined, options).format(date)
+	}
+}
+
+/**
+ * Whole calendar days from the date until `now` (0 today, 1 yesterday), or
+ * null when the value is not a date. A future date gives a negative number.
+ *
+ * @param {unknown} value The date.
+ * @param {Date} [now] The reference moment.
+ * @return {number|null} The day count.
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md#requirement-an-age-cell-says-how-long-something-has-waited
+ */
+export function ageInDays(value, now = new Date()) {
+	const date = parseDateValue(value)
+	if (date === null) {
+		return null
+	}
+	// UTC midnights of the two LOCAL days, so a daylight-saving hour never
+	// turns one day into zero or two.
+	const start = Date.UTC(date.getFullYear(), date.getMonth(), date.getDate())
+	const today = Date.UTC(now.getFullYear(), now.getMonth(), now.getDate())
+	return Math.round((today - start) / MS_PER_DAY)
+}
+
+/**
+ * How long something has waited: "4 uur" under 24 hours (at least 1), else
+ * "1 dag" / "3 dagen" in whole calendar days. Plural forms come from the
+ * library's own catalogue (`nextcloud-vue`). A date in the future reads as
+ * waiting no time: "0 hours".
+ *
+ * @param {unknown} value The moment the wait started.
+ * @param {Date} [now] The reference moment.
+ * @return {string} The age, or '' when the value is not a date.
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md#requirement-an-age-cell-says-how-long-something-has-waited
+ */
+export function formatAge(value, now = new Date()) {
+	const date = parseDateValue(value)
+	if (date === null) {
+		return ''
+	}
+	const elapsed = now.getTime() - date.getTime()
+	if (elapsed < MS_PER_DAY) {
+		const hours = elapsed <= 0 ? 0 : Math.max(1, Math.floor(elapsed / MS_PER_HOUR))
+		return n('nextcloud-vue', '%n hour', '%n hours', hours)
+	}
+	const days = shownAgeDays(date, now)
+	return n('nextcloud-vue', '%n day', '%n days', days)
+}
+
+/**
+ * The number of days an age cell shows: 0 under 24 hours (the cell then reads
+ * hours), else the whole calendar days, at least 1. The threshold rules
+ * compare against this number, so the colour always agrees with the text.
+ *
+ * @param {unknown} value The moment the wait started.
+ * @param {Date} [now] The reference moment.
+ * @return {number|null} The day count, or null when the value is not a date.
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md#requirement-an-age-cell-turns-red-past-its-threshold
+ */
+export function shownAgeDays(value, now = new Date()) {
+	const date = parseDateValue(value)
+	if (date === null) {
+		return null
+	}
+	if (now.getTime() - date.getTime() < MS_PER_DAY) {
+		return 0
+	}
+	return Math.max(1, ageInDays(date, now))
+}
+
+/**
+ * The variant of the first `variantWhen` rule the age in days matches, or ''
+ * when none does. Same rule shape as the `date` widget (`{ op, value,
+ * variant }`, first match wins), compared against the number of days the cell
+ * shows (`shownAgeDays`): `[{ op: "gte", value: 3, variant: "error" }]` turns a wait of three
+ * days or more red.
+ *
+ * @param {unknown} value The moment the wait started.
+ * @param {Array<{op: string, value: number, variant: string}>} rules The rules.
+ * @param {Date} [now] The reference moment.
+ * @return {string} `success | warning | error | default`, or ''.
+ * @spec openspec/changes/screens-cell-date-parity/specs/cell-date-age/spec.md#requirement-an-age-cell-turns-red-past-its-threshold
+ */
+export function resolveAgeVariant(value, rules, now = new Date()) {
+	if (!Array.isArray(rules) || rules.length === 0) {
+		return ''
+	}
+	const days = shownAgeDays(value, now)
+	if (days === null) {
+		return ''
+	}
+	for (const rule of rules) {
+		if (!rule || typeof rule !== 'object') {
+			continue
+		}
+		if (compareVisibleWhen(days, rule.op || 'eq', rule.value) === true) {
+			const variant = rule.variant === 'danger' ? 'error' : rule.variant
+			return AGE_VARIANTS.includes(variant) ? variant : ''
+		}
+	}
+	return ''
+}

package/src/utils/dynamicProperties.js

@@ -101,6 +101,7 @@ const DEFAULT_MAP = {
 	enum: 'enumValues',
 	required: 'isRequired',
 	default: 'defaultValue',
+	hideOnCreate: 'hideOnCreate',
 }
 
 /**
@@ -312,6 +313,8 @@ export function definitionQueryParams(config, value, formData = {}) {
  * @param {object} [config] The `x-openregister-extends-form` block (`map`, `typeMap`).
  * @param {object} [options] Extra options.
  * @param {number} [options.orderFrom] Order assigned to the first field; each subsequent field takes the next integer. Dynamic fields sort after the schema's own, so pass a number above every declared `order`.
+ * @param {boolean} [options.create] The form creates a new object: a definition whose `hideOnCreate` (or the field `config.map.hideOnCreate` names) is `true` gets no field, because the app fills that answer itself at creation. Edit forms still show it.
+ * @spec openspec/changes/dynamic-question-hide-on-create/specs/dynamic-question-hide-on-create/spec.md#requirement-a-question-can-stay-off-the-create-form
  * @return {{properties: object, required: string[]}} Properties keyed by prefixed id, plus the required key list.
  */
 export function propertiesFromDefinitions(definitions, config = {}, options = {}) {
@@ -321,7 +324,8 @@ export function propertiesFromDefinitions(definitions, config = {}, options = {}
 
 	const properties = {}
 	const required = []
-	const list = Array.isArray(definitions) ? definitions : []
+	const list = (Array.isArray(definitions) ? definitions : [])
+		.filter((record) => !(options.create === true && record && mapped(record, map, 'hideOnCreate') === true))
 
 	list.forEach((record, index) => {
 		if (!record || !record.id) {