@conduction/nextcloud-vue 2.60.0 → 2.62.0

package/src/components/index.js

@@ -221,6 +221,7 @@ export { CnFlowEditorPage, CnFlowsPage } from './CnFlowsPage/index.js'
 export { default as CnWidgetRefItem } from './CnWidgetRefItem/index.js'
 export { CnReportsPage } from './CnReportsPage/index.js'
 export { CnStorePage } from './CnStorePage/index.js'
+export { CnLinkCardsPage } from './CnLinkCardsPage/index.js'
 export { CnPageRenderer, defaultPageTypes } from './CnPageRenderer/index.js'
 export { CnAppNav } from './CnAppNav/index.js'
 export { CnAppLoading } from './CnAppLoading/index.js'

package/src/css/detail-page.css

@@ -73,9 +73,17 @@
 	font-weight: 700;
 	line-height: 1.3;
 	color: var(--color-main-text);
-	white-space: nowrap;
+	/* Two lines, then an ellipsis. One line cut a long case title short on a
+	   page with room to spare, and the title is the one thing that says which
+	   record this is. The element carries the full text as its `title`, so a
+	   title cut after two lines is still reachable. `overflow-wrap` breaks a
+	   word longer than the line, which nowrap used to hide. */
+	display: -webkit-box;
+	-webkit-box-orient: vertical;
+	-webkit-line-clamp: 2;
+	line-clamp: 2;
 	overflow: hidden;
-	text-overflow: ellipsis;
+	overflow-wrap: anywhere;
 }
 
 .cn-detail-page__subtitle {

package/src/css/table.css

@@ -295,8 +295,7 @@
 	outline-offset: -2px;
 }
 
-/* Multi-column sort priority badge (1, 2, 3) — only rendered once more than
-   one sort key is active; a single active sort shows the arrow alone. */
+/* Multi-column sort priority badge (1, 2, 3), rendered only when two or more rendered, sortable columns are sorted. */
 .cn-table-sort-badge {
 	display: inline-flex;
 	align-items: center;

package/src/index.js

@@ -311,6 +311,13 @@ export { CnOpenBuildEditButton } from './components/index.js'
 // control, and the brand stripe.
 export { CnBrandStripe, CnSegmentedControl, CnStackedBarWidget, CnStackedBarWidgetForm, CnWeekStripWidget, CnWeekStripWidgetForm } from './components/index.js'
 
+// Page components the page renderer mounts by `pages[].type` that were missing
+// from this entry. A component reachable from a manifest but not importable
+// here resolves to `undefined` in a host that mounts it by hand, and renders
+// nothing without an error. tests/packaging/page-types-are-exported.spec.js
+// keeps the two lists together.
+export { CnFormPage, CnLinkCardsPage, CnMapPage, CnReportsPage, CnStorePage, CnWikiPage } from './components/index.js'
+
 // AI Chat Companion component family
 export {
 	CnAiAgentPicker,

package/src/public/index.js

@@ -40,6 +40,10 @@
  * claiming purity is worth nothing; the check is in CI.
  */
 
+// The brand stripe imports nothing at all, so it is public-safe as it is: a
+// portal draws the organisation's motif under its header with the same
+// component, and the same tokens, as a Nextcloud page (brand-motif-token).
+import CnBrandStripe from '../components/CnBrandStripe/CnBrandStripe.vue'
 import CnSiteCard from './components/CnSiteCard.vue'
 import CnSiteCardGrid from './components/CnSiteCardGrid.vue'
 import CnSiteEmptyState from './components/CnSiteEmptyState.vue'
@@ -50,6 +54,7 @@ import CnSiteSearch from './components/CnSiteSearch.vue'
 import CnSiteSection from './components/CnSiteSection.vue'
 
 export {
+	CnBrandStripe,
 	CnSiteCard,
 	CnSiteCardGrid,
 	CnSiteEmptyState,

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.42.0",
+	"version": "2.43.0",
 	"type": "object",
 	"required": ["$schema", "version"],
 	"allOf": [
@@ -1328,6 +1328,29 @@
 				}
 			}
 		},
+		"linkCard": {
+			"type": "object",
+			"required": ["id", "label"],
+			"additionalProperties": false,
+			"description": "One card on a type='links' page: a link to another page of the app, or to a URL. Same vocabulary as menuItem and navCardEntry.",
+			"properties": {
+				"id": { "type": "string", "minLength": 1, "description": "Unique within the page's cards." },
+				"label": { "type": "string", "minLength": 1, "description": "i18n key / text of the card's title." },
+				"description": { "type": "string", "description": "i18n key / one line under the title." },
+				"icon": { "type": "string", "description": "MDI icon name (e.g. 'CashMultiple')." },
+				"category": { "type": "string", "description": "Key in config.categories naming the group this card sits in. A card without one, or with an unknown one, renders first under no caption." },
+				"route": { "type": "string", "minLength": 1, "description": "Route name (a pages[].id), or a router path when it starts with '/'. Resolved through the router, so it works with and without /index.php. Mutually exclusive with href." },
+				"params": { "type": "object", "description": "Route params passed along with `route`.", "additionalProperties": { "type": ["string", "number"] } },
+				"query": { "type": "object", "description": "Query passed along with `route`.", "additionalProperties": { "type": ["string", "number", "boolean"] } },
+				"href": { "type": "string", "minLength": 1, "description": "External URL, opened in a new tab. Mutually exclusive with route." },
+				"permission": { "type": "string", "description": "Permission the user must hold for the card to render. Same rule as menuItem.permission." },
+				"visibleIf": { "$ref": "#/$defs/visibleIfCondition", "description": "Display condition, evaluated the way a menu entry's is." }
+			},
+			"allOf": [
+				{ "not": { "required": ["route", "href"] } },
+				{ "anyOf": [{ "required": ["route"] }, { "required": ["href"] }] }
+			]
+		},
 		"navCardEntry": {
 			"type": "object",
 			"required": ["id", "label"],
@@ -2858,8 +2881,8 @@
 				"type": {
 					"type": "string",
 					"enum": ["index", "detail", "dashboard", "logs", "settings", "chat", "files", "form", "map", "roadmap", "reports",
-						"store", "search", "wiki", "flow", "flows", "flow-detail", "custom"],
-					"description": "Page type. Closed enum of 17 supported types. 'flow' opens ONE flow in the editor; the flow LIST is an ordinary 'index' with config.entitySource='flows'. 'flows' and 'flow-detail' are DEPRECATED aliases kept for migration — 'flows' predates named index sources and 'flow-detail' is the old name for 'flow'. 'roadmap' mounts CnFeaturesAndRoadmapPage (features + GitHub-issue-backed roadmap). 'search' mounts CnSearchPage (cross-schema query + facet sidebar + results list; consumers wire the actual search via @search). 'wiki' mounts CnWikiPage (manifest-declared markdown article + optional sidebar tree; MUST declare config.register + config.schema). 'flow' and the deprecated 'flow-detail' both mount CnFlowEditorPage (the shared node/edge canvas) and take config.app to scope to the owning app. A flow lives in OpenRegister's native flow store rather than a register/schema pair, so a single flow cannot be a 'detail' page — but the LIST is a plain 'index' once a named entitySource supplies it, which is why 'flows' is deprecated (ADR-110 Decision 4). 'custom' requires a _note field explaining why a standard type was not feasible."
+						"links", "store", "search", "wiki", "flow", "flows", "flow-detail", "custom"],
+					"description": "Page type. Closed enum of 18 supported types. 'links' mounts CnLinkCardsPage: a page of link cards grouped under captions, declared with config.categories + config.cards ($defs/linkCard). Use it for the pages a short menu leaves out; unlike 'reports' an app may have several. 'flow' opens ONE flow in the editor; the flow LIST is an ordinary 'index' with config.entitySource='flows'. 'flows' and 'flow-detail' are DEPRECATED aliases kept for migration — 'flows' predates named index sources and 'flow-detail' is the old name for 'flow'. 'roadmap' mounts CnFeaturesAndRoadmapPage (features + GitHub-issue-backed roadmap). 'search' mounts CnSearchPage (cross-schema query + facet sidebar + results list; consumers wire the actual search via @search). 'wiki' mounts CnWikiPage (manifest-declared markdown article + optional sidebar tree; MUST declare config.register + config.schema). 'flow' and the deprecated 'flow-detail' both mount CnFlowEditorPage (the shared node/edge canvas) and take config.app to scope to the owning app. A flow lives in OpenRegister's native flow store rather than a register/schema pair, so a single flow cannot be a 'detail' page — but the LIST is a plain 'index' once a named entitySource supplies it, which is why 'flows' is deprecated (ADR-110 Decision 4). 'custom' requires a _note field explaining why a standard type was not feasible."
 				},
 				"title": {
 					"type": "string",
@@ -3652,6 +3675,25 @@
 						"required": ["config"]
 					}
 				},
+				{
+					"description": "type='links' (CnLinkCardsPage) renders config.cards as link cards grouped by config.categories. It MUST declare a non-empty cards list, and every card is a $defs/linkCard, so a card that can go nowhere is refused here and not dropped in silence at render time (link-cards-page).",
+					"if": { "properties": { "type": { "const": "links" } }, "required": ["type"] },
+					"then": {
+						"properties": {
+							"config": {
+								"type": "object",
+								"required": ["cards"],
+								"properties": {
+									"description": { "type": "string" },
+									"emptyLabel": { "type": "string" },
+									"categories": { "type": "object", "additionalProperties": { "type": "string", "minLength": 1 } },
+									"cards": { "type": "array", "minItems": 1, "items": { "$ref": "#/$defs/linkCard" } }
+								}
+							}
+						},
+						"required": ["config"]
+					}
+				},
 				{
 					"description": "type='custom' requires _note documenting why decomposition into a standard page type was not feasible. Relaxed by ConductionNL/nextcloud-vue#315: when `component` matches the lib `Cn[A-Z]\\w+` pattern, the component name already documents the choice and _note is optional. When `component` is absent or non-Cn (host-app SFC), _note remains required.",
 					"if": {

package/src/types/manifest.d.ts

@@ -27,7 +27,7 @@
  */
 export type TPageType =
 	| 'index' | 'detail' | 'dashboard' | 'logs' | 'settings' | 'chat'
-	| 'files' | 'form' | 'map' | 'roadmap' | 'reports' | 'store' | 'search' | 'wiki'
+	| 'files' | 'form' | 'map' | 'roadmap' | 'reports' | 'links' | 'store' | 'search' | 'wiki'
 	| 'flow'
 	/** @deprecated `flows` predates named index sources — use `index` with `config.source: 'flows'`. */
 	| 'flows'

package/src/utils/headers.js

@@ -130,10 +130,15 @@ export function capitalize(str) {
  *
  * Array values are serialized with PHP bracket notation (`key[]=a&key[]=b`)
  * so the Nextcloud/OpenRegister backend parses them as an array — a plain
- * repeated `key=a&key=b` collapses to the last value in PHP. Also handles
- * _order serialization (JSON.stringify for objects) and skips
+ * repeated `key=a&key=b` collapses to the last value in PHP. A plain object
+ * under a filter key is a set of operators and goes out in bracket form
+ * (`{ deadline: { lt: 'x' } }` becomes `deadline[lt]=x`); a key already
+ * written that way (`'deadline[lt]'`) passes through unchanged. Reserved keys
+ * that start with `_` keep their JSON form (`_order`). Skips
  * null/undefined/empty values.
  *
+ * @spec openspec/changes/link-cards-page/specs/link-cards-page/spec.md#requirement-a-filter-operator-is-serialised-in-bracket-form
+ *
  * @param {object} params Key-value pairs for query parameters
  * @return {string} Query string including leading '?' or empty string
  */
@@ -159,6 +164,27 @@ export function buildQueryString(params = {}) {
 					queryParams.append(arrayKey, String(item))
 				}
 			}
+		} else if (typeof value === 'object' && !key.startsWith('_')) {
+			// A filter operator: `{ deadline: { lt: '2026-10-06' } }` goes out
+			// as `deadline[lt]=2026-10-06`, the form OpenRegister reads. As
+			// JSON it reached the database as the literal value and a date
+			// column answered 500. Reserved `_` keys (`_order`) keep JSON.
+			for (const [op, operand] of Object.entries(value)) {
+				if (operand === undefined || operand === null || operand === '') {
+					continue
+				}
+				if (Array.isArray(operand)) {
+					for (const item of operand) {
+						if (item !== undefined && item !== null && item !== '') {
+							queryParams.append(`${key}[${op}][]`, String(item))
+						}
+					}
+				} else if (typeof operand === 'object') {
+					queryParams.set(`${key}[${op}]`, JSON.stringify(operand))
+				} else {
+					queryParams.set(`${key}[${op}]`, String(operand))
+				}
+			}
 		} else if (typeof value === 'object') {
 			queryParams.set(key, JSON.stringify(value))
 		} else {