@conduction/nextcloud-vue 2.79.0 → 2.81.0

package/src/css/look-board-index.css

@@ -249,7 +249,8 @@
 }
 
 /* Filter: a labelled secondary button, 36px, radius 8, with the active count. */
-.cn-look-board .cn-actions-bar__filter-button.button-vue {
+.cn-look-board .cn-actions-bar__filter-button.button-vue,
+.cn-look-board .cn-actions-bar__filter-menu .button-vue {
 	min-height: 36px;
 	height: 36px;
 	border-radius: 8px;
@@ -301,6 +302,15 @@
 	color: var(--color-main-text);
 }
 
+/* A segment the page cannot open: drawn, as the boards do, but faded and inert. */
+.cn-look-board .cn-actions-bar--board .cn-actions-bar__view-toggle .cn-actions-bar__view-toggle-btn--disabled,
+.cn-look-board .cn-actions-bar--board .cn-actions-bar__view-toggle .cn-actions-bar__view-toggle-btn--disabled:hover {
+	background: transparent !important;
+	color: var(--color-text-maxcontrast);
+	opacity: 0.5;
+	cursor: not-allowed;
+}
+
 /* The search field: 40px, radius 8, not a pill. */
 .cn-look-board .cn-actions-bar--board .cn-actions-bar__search {
 	flex: 1 1 260px;
@@ -448,11 +458,58 @@
 	border-bottom: 0;
 }
 
-/* The selection column: 28px, 18px checkboxes. */
+/* The table fits its card (screens-index-table-fit-parity). Under the auto
+   layout every one-line cell asked for its whole text up to the 22rem cap, so
+   seven text columns made a 1500px table in a 1118px card at a 1440px
+   viewport: the last columns and the row menus sat past the card's edge. The
+   fixed layout shares the card's width: the selection and menu columns keep
+   their own width, the first data column takes 18%, the others split the
+   rest, and a value that does not fit is cut with an ellipsis (its full text
+   stays in the cell's tooltip). A column's own `width` still wins. */
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table {
+	table-layout: fixed;
+	width: 100%;
+}
+
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table th.cn-table-head--title {
+	width: 18%;
+}
+
+/* The board's data cells sit 12px apart (PqTickets), the first one 18px from
+   the selection column; the selection and menu columns keep 16px. */
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table th:not(.cn-table-col--checkbox):not(.cn-table-col--actions):not(.cn-table-col--icon),
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table td:not(.cn-table-col--checkbox):not(.cn-table-col--actions):not(.cn-table-col--icon) {
+	padding-inline: 12px;
+}
+
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table th.cn-table-head--title,
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table td.cn-table-col--title {
+	padding-inline-start: 18px;
+}
+
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table td > .cn-cell-renderer {
+	display: block;
+	min-width: 0;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
+/* A narrow header cuts its label, not its filter funnel. */
+.cn-look-board .cn-index-page__main--table .cn-table-container--board .cn-data-table th .cn-table-header__sort:has(~ .cn-table-header__filter) {
+	max-width: calc(100% - 26px);
+}
+
+/* The selection column: 18px checkboxes, 28px of content after 16px of padding.
+   The box model is set with `!important` and the widths include the padding:
+   Nextcloud's server.css sets `box-sizing: border-box` on everything under
+   `#content[class*="app-"]`, an id selector no class rule outranks, so a plain
+   `content-box` here was ignored and the cell left 12px for the checkbox (the
+   header's checkbox showed as a stray bracket). */
 .cn-look-board .cn-table-container--board .cn-data-table .cn-table-col--checkbox {
-	box-sizing: content-box;
-	width: 28px;
-	min-width: 28px;
+	box-sizing: border-box !important;
+	width: 44px;
+	min-width: 44px;
 	padding-inline: 16px 0;
 	text-align: start;
 }
@@ -500,6 +557,29 @@
 	font-size: 13px;
 }
 
+/* An avatar in the title column (PtAccounts): a 32px chip circle, 10px before
+   the name, the e-mail under the name beside it. The name keeps the title's
+   weight and size, and its underline: an inline-flex box is atomic, so the
+   cell's own underline does not reach it. */
+.cn-look-board .cn-table-container--board .cn-data-table .cn-cell-renderer__avatar {
+	gap: 10px;
+}
+
+.cn-look-board .cn-table-container--board .cn-data-table .cn-cell-renderer__avatar-initials {
+	background: var(--color-background-dark);
+	color: var(--color-main-text);
+	font-size: 12px;
+}
+
+.cn-look-board .cn-table-container--board .cn-data-table td.cn-table-col--title .cn-cell-renderer__avatar-name {
+	text-decoration: underline;
+	text-underline-offset: 2px;
+}
+
+.cn-look-board .cn-table-container--board.cn-table-container--title-plain .cn-data-table td.cn-table-col--title .cn-cell-renderer__avatar-name {
+	text-decoration: none;
+}
+
 /* A status pill: 3px 10px, radius 12, 13px weight 600. The colours stay the
    status colour map's. */
 .cn-look-board .cn-table-container--board .cn-data-table .cn-status-badge {
@@ -510,10 +590,12 @@
 	line-height: 1.4;
 }
 
-/* The row menu column holds one 34px button. */
+/* The row menu column holds one 34px button between 16px of padding, so 66px
+   border to border (see the selection column for why the box model is forced). */
 .cn-look-board .cn-table-container--board .cn-data-table .cn-table-col--actions {
-	width: 34px;
-	min-width: 0;
+	box-sizing: border-box !important;
+	width: 66px;
+	min-width: 66px;
 	padding-inline: 16px;
 	text-align: end;
 }

package/src/css/look-board.css

@@ -12,9 +12,14 @@
  * counterpart default to one.
  */
 .cn-look-board {
-	/* Page content area: padding, max width, gap between blocks. */
+	/* Page content area: padding, max width, gap between blocks. The content
+	   spans the whole content area (screens-one-scroller-parity): grids grow
+	   with the window and shrink only when the sidebar takes its share. A
+	   1240px cap left dead space right of the content, and on a dashboard,
+	   which scrolled itself, put the scrollbar beside the content instead of
+	   at the window edge. */
 	--cn-board-content-padding: 24px 28px;
-	--cn-board-content-max-width: 1240px;
+	--cn-board-content-max-width: none;
 	--cn-board-section-gap: 20px;
 	/* Buttons and inputs. */
 	--cn-board-control-height: 40px;
@@ -54,6 +59,15 @@
 	gap: var(--cn-board-section-gap);
 }
 
+/* One scroller: the content area. CnDashboardPage scrolls itself
+   (`height: 100%; overflow-y: auto`), which nested a second scrollbar inside
+   NcAppContent's; under the board look the page grows with its widgets and
+   NcAppContent, which already spans to the window edge, scrolls it. */
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) {
+	height: auto;
+	overflow-y: visible;
+}
+
 .cn-look-board .cn-index-page:not(.cn-look-nextcloud *) .cn-page-header,
 .cn-look-board .cn-settings-page:not(.cn-look-nextcloud *) .cn-page-header,
 .cn-look-board .cn-index-page:not(.cn-look-nextcloud *) .cn-index-page__below-header,
@@ -167,6 +181,27 @@
 	gap: 2px;
 }
 
+/* No scrollbars inside the navigation (screens-one-scroller-parity).
+   NcAppNavigation gives the region above the list `overflow-y: scroll`, an
+   always-on track (with arrow buttons on classic scrollbars) beside the
+   primary action that has nothing to scroll. It takes its content's height
+   instead. A menu taller than the window still scrolls (wheel, touch, focus),
+   without drawing a bar of its own; the one visible scrollbar is the page's. */
+.cn-look-board .app-navigation[data-testid="cn-nav"] .app-navigation__body:not(.app-navigation__body--no-list) {
+	flex-shrink: 0;
+	overflow: visible;
+}
+
+.cn-look-board .app-navigation[data-testid="cn-nav"] .app-navigation__list,
+.cn-look-board .app-navigation[data-testid="cn-nav"] .app-navigation__body--no-list {
+	scrollbar-width: none;
+}
+
+.cn-look-board .app-navigation[data-testid="cn-nav"] .app-navigation__list::-webkit-scrollbar,
+.cn-look-board .app-navigation[data-testid="cn-nav"] .app-navigation__body--no-list::-webkit-scrollbar {
+	display: none;
+}
+
 /* The board's vertical rhythm (AppZijbalk): the primary action 20px from the
    top, the list 20px under it, entries 2px apart. An empty search slot is a
    flex child too and pushed everything 20px down, so it goes. */
@@ -520,3 +555,75 @@
 .cn-look-board .cn-cell-renderer__age:not(.cn-look-nextcloud *) {
 	font-weight: 600;
 }
+
+/* ---- Record list on a dashboard card (PtDashboard) ---------------------- */
+/* The dashboard's card body is flush, so the rows carry their own inset: the
+   board's card pads 24px at the sides and each row 14px, a soft hairline
+   between rows, the title 15px weight 600 and the meta 13px muted. A row is a
+   link, but only the hover says so: no underline on any text run, however the
+   host styles its links (`!important`, because a host rule such as
+   `#content a` outranks any class). The pill and the date sit at the right. */
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list {
+	padding: 0 24px 10px;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list--rows .cn-record-list__item + .cn-record-list__item {
+	border-top: 1px solid var(--color-border-dark, var(--color-border));
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row {
+	padding: 14px 0;
+	flex-wrap: wrap;
+	gap: 8px 16px;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row,
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row:hover,
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row:focus-visible,
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row * {
+	color: inherit;
+	text-decoration: none !important;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__title {
+	color: var(--color-main-text);
+	font-size: 15px;
+	font-weight: 600;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__meta {
+	color: var(--color-text-maxcontrast);
+	font-size: 13px;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__trailing {
+	color: var(--color-text-maxcontrast);
+	font-size: 13px;
+	font-weight: 600;
+}
+
+/* Hover: the whole row takes the hover ground, 8px beyond the text so the
+   text does not move. */
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row--link {
+	margin-inline: -8px;
+	padding-inline: 8px;
+	border-radius: 8px;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row--link:hover,
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row--link:focus-visible {
+	background: var(--color-background-hover);
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__row--link:hover .cn-record-list__title {
+	text-decoration: none !important;
+}
+
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__aside {
+	margin-inline-start: auto;
+}
+
+/* The board draws no chevron after the pill and date. */
+.cn-look-board .cn-dashboard-page:not(.cn-look-nextcloud *) .cn-record-list__chevron {
+	display: none;
+}

package/src/css/table.css

@@ -258,6 +258,25 @@
 	white-space: nowrap;
 }
 
+/* The secondary line of the growing column ("2026-0004" under a case title)
+   is a line of its own with its own ellipsis. The cell does not wrap, so in
+   the board look, where the secondary line is an inline block (the title
+   underline cannot reach an atomic inline box), it stayed on the title's line
+   and ran out of the tile. A full-width float is a block (computed `display:
+   block`) that always starts under the line before it, and, being out of the
+   flow, the cell's underline does not reach it either. The cell is a table
+   cell, which contains its floats, so the row grows to hold the line.
+   @spec openspec/changes/dashboard-tile-text-fits/specs/dashboard-tile-text-fits/spec.md#requirement-the-secondary-line-of-a-narrow-tables-growing-column-sits-under-the-value */
+.cn-data-table.cn-data-table--fit td.cn-table-col--grow .cn-table-cell__secondary {
+	float: inline-start;
+	clear: both;
+	box-sizing: border-box;
+	width: 100%;
+	overflow: hidden;
+	text-overflow: ellipsis;
+	white-space: nowrap;
+}
+
 .cn-data-table th {
 	background: var(--color-background-dark);
 	font-weight: 500;

package/src/index.js

@@ -43,6 +43,8 @@ export {
 	CnAppNav,
 	CnAppRoot,
 	CnAuditTrailCard,
+	CnAuditTrailWidget,
+	CnBannerWidget,
 	CnBoardView,
 	CnBodySections,
 	CnBreadcrumbs,
@@ -58,7 +60,9 @@ export {
 	CnChartWidgetForm,
 	CnChatPage,
 	CnChildRecordsField,
+	CnChipsFieldWidget,
 	CnChoiceCards,
+	CnChoicePickerWidget,
 	CnColorPicker,
 	CnCommandPalette,
 	CnConfigurationCard,
@@ -70,6 +74,7 @@ export {
 	CnContainerWidgetForm,
 	CnContextMenu,
 	CnConversationThread,
+	CnConversationWidget,
 	CnCopyDialog,
 	CnCountdownWidget,
 	CnCountdownWidgetForm,
@@ -97,6 +102,7 @@ export {
 	CnDividerWidget,
 	CnDividerWidgetForm,
 	CnDocumentReviewList,
+	CnDocumentReviewWidget,
 	CnDurationField,
 	CnEditActionsModal,
 	CnEditDataModal,
@@ -112,6 +118,7 @@ export {
 	CnEnvironmentBanner,
 	CnExportWizard,
 	CnFacetSidebar,
+	CnFactsWidget,
 	CnFavouriteToggle,
 	CnFeaturesAndRoadmapLink,
 	CnFeaturesAndRoadmapPage,
@@ -120,6 +127,7 @@ export {
 	CnFeaturesTab,
 	CnFederationStatus,
 	CnFieldHelper,
+	CnFieldListWidget,
 	CnFileField,
 	CnFileManager,
 	CnFilePreview,
@@ -162,11 +170,13 @@ export {
 	CnIntegrationTab,
 	CnIntegrationWidget,
 	CnIntegrationWidgetGrid,
+	CnInteractionFormWidget,
 	CnItemCard,
 	CnJourney,
 	CnJourneyDialog,
 	CnJourneyReviewList,
 	CnJsonViewer,
+	CnKbSearchWidget,
 	CnKpiGrid,
 	CnLabelWidget,
 	CnLabelWidgetForm,
@@ -198,6 +208,7 @@ export {
 	CnNcWidgetGridPicker,
 	CnNcWidgetWidget,
 	CnNextStepCard,
+	CnNextStepWidget,
 	CnNoteBody,
 	CnNoteCard,
 	CnNoteComposer,
@@ -236,6 +247,8 @@ export {
 	CnQuickFilterBar,
 	CnQuicklinksWidget,
 	CnQuicklinksWidgetForm,
+	CnRadioCardsWidget,
+	CnRecordListWidget,
 	CnReferencePreview,
 	CnRegisterMapping,
 	CnRegisterSchemaSelect,
@@ -253,12 +266,15 @@ export {
 	CnSavedViewsControl,
 	CnSavedViewShareDialog,
 	CnSavedViewShareFields,
+	CnSavedViewsWidget,
 	CnSavedViewWidget,
 	CnSavedViewWidgetForm,
 	CnSaveViewDialog,
 	CnSchemaFormDialog,
 	CnSearchPage,
+	CnSectionsWidget,
 	CnSettingsCard,
+	CnSettingsFormWidget,
 	CnSettingsPage,
 	CnSettingsSection,
 	CnSetupWizard,
@@ -278,6 +294,7 @@ export {
 	CnSubObjectsField,
 	CnSummaryAggregates,
 	CnSupportDialog,
+	CnSwitchRowsWidget,
 	CnTab,
 	CnTabbedFormDialog,
 	CnTableWidget,
@@ -298,6 +315,7 @@ export {
 	CnTimelineStages,
 	CnTimelineView,
 	CnTimelineWidget,
+	CnToggleTableWidget,
 	CnTranslatedBadge,
 	CnTreeView,
 	CnUnreadMarker,
@@ -320,6 +338,7 @@ export {
 	CnWidgetVisibilityRulesModal,
 	CnWidgetWrapper,
 	CnWizardDialog,
+	CnWorkspaceFilterWidget,
 	DEFAULT_DATE_RANGE_PRESETS,
 	defaultPageTypes,
 	fetchWebdavFolderTree,

package/src/integrations/builtin/field-inspection/CnFieldInspectionCard.vue

@@ -134,6 +134,13 @@
 					     (an invalid `ButtonType`, so the visual primary style never applied
 					     either). See CnFormPage.vue's inline comment for the submit-button
 					     half of this bug in detail. -->
+					<p v-if="saveError"
+						class="cn-field-inspection__error"
+						role="alert"
+						data-testid="cn-fi-save-error">
+						{{ saveError }}
+					</p>
+
 					<NcButton type="submit"
 						variant="primary"
 						data-testid="cn-fi-save"
@@ -157,7 +164,8 @@ import { NcButton, NcEmptyContent, NcLoadingIcon } from '@nextcloud/vue'
 import ClipboardCheckOutline from 'vue-material-design-icons/ClipboardCheckOutline.vue'
 import CnDetailCard from '../../../components/CnDetailCard/CnDetailCard.vue'
 import CnOfflineQueue from '../../../components/CnOfflineQueue/index.js'
-import { checklistProgress, classifyGps, syncIndicator, validateChecklistAnswers } from '../../offline/fieldCollectionHelpers.js'
+import { buildChecklistSubmission } from '../../offline/checklistSubmission.js'
+import { checklistProgress, classifyGps, normaliseChecklistTemplate, syncIndicator, validateChecklistAnswers } from '../../offline/fieldCollectionHelpers.js'
 import {
 	countPending,
 	countStuck,
@@ -236,6 +244,8 @@ export default {
 			activeTemplate: null,
 			answers: {},
 			errors: [],
+			/** Why the last save could not be queued, in words. */
+			saveError: '',
 		}
 	},
 
@@ -449,8 +459,13 @@ export default {
 			this.errors = []
 			const cfg = this.config
 			const templateRef = item?.[cfg.templateRefField]
+			// The app's template shape (sections, its own item keys and type
+			// words) is read into the leaf's flat item list here, once.
 			this.activeTemplate = templateRef
-				? await getCachedObject(this.effectiveRegister, cfg.referenceSchema, 'references', String(templateRef))
+				? normaliseChecklistTemplate(
+						await getCachedObject(this.effectiveRegister, cfg.referenceSchema, 'references', String(templateRef)),
+						cfg,
+					)
 				: null
 			const initial = {}
 			for (const q of (this.activeTemplate?.items || [])) {
@@ -464,6 +479,7 @@ export default {
 			this.activeTemplate = null
 			this.answers = {}
 			this.errors = []
+			this.saveError = ''
 		},
 
 		/**
@@ -485,7 +501,9 @@ export default {
 		},
 
 		/**
-		 * Validate answers, then queue a `create` mutation for the result.
+		 * Validate answers, then queue the run: an object create on
+		 * `resultSchema`, or, when the config names a `resultEndpoint`, one
+		 * `submit` to that endpoint.
 		 *
 		 * @return {Promise<void>}
 		 */
@@ -499,26 +517,22 @@ export default {
 			try {
 				const cfg = this.config
 				const gps = await this.captureGps()
-				const gpsClass = classifyGps(gps)
-				const now = new Date().toISOString()
-				const items = this.activeTemplate.items.map((q) => ({
-					questionId: q.questionId,
-					answer: this.answers[q.questionId].answer,
-					evidenceRefs: this.answers[q.questionId].evidenceRefs,
-					answeredAt: now,
-					gpsAtAnswer: gps ? { ...gps, source: gpsClass.source } : { source: 'sensorless' },
-				}))
-				const payload = {
-					inspectionRef: this.itemId(this.activeItem),
-					checklistTemplateRef: this.activeTemplate.id ?? this.activeTemplate['@self']?.id,
-					items,
-				}
+				const submission = buildChecklistSubmission(cfg, {
+					plannedItem: this.activeItem,
+					template: this.activeTemplate,
+					answers: this.answers,
+					gps,
+					gpsSource: classifyGps(gps).source,
+					capturedAt: new Date().toISOString(),
+					capturedOffline: this.offline,
+				})
 				await enqueueMutation({
 					deviceId: this.deviceId,
-					operationType: 'create',
+					operationType: submission.operationType,
 					register: this.effectiveRegister,
-					schema: cfg.resultSchema,
-					payload,
+					schema: submission.schema,
+					endpoint: submission.endpoint,
+					payload: submission.payload,
 				})
 				this.pendingCount = await countPending(this.deviceId)
 				this.stuckCount = await countStuck(this.deviceId)
@@ -527,6 +541,7 @@ export default {
 					await this.drain()
 				}
 			} catch (e) {
+				this.saveError = e?.message || t('nextcloud-vue', 'The answers could not be saved on this device.')
 				// eslint-disable-next-line no-console
 				console.error('[CnFieldInspectionCard] saveChecklist failed', e)
 			} finally {

package/src/integrations/builtin/field-inspection.js

@@ -56,6 +56,27 @@ export const DEFAULT_FIELD_INSPECTION_CONFIG = {
 	// Schema holding conflict records. Empty keeps a conflict on the device,
 	// and the queue row says so rather than pretending it was filed.
 	conflictSchema: '',
+	// How a template's items are read (normaliseChecklistTemplate). Empty
+	// `sectionsField` reads a flat `items[]`; set it when the items sit inside
+	// ordered sections, each with its own `items[]`.
+	sectionsField: '',
+	itemKeyField: 'questionId',
+	itemTextField: 'text',
+	itemTypeField: 'type',
+	// The app's own item type words onto the leaf's (`yes_no`,
+	// `photo_required`; anything else renders as free text).
+	itemTypeMap: {},
+	// An item whose `photoRequiredField` equals `photoRequiredValue` needs a
+	// photo as well as an answer. Empty switches the gate off.
+	photoRequiredField: '',
+	photoRequiredValue: '',
+	// Where a finished run goes (checklistSubmission). Empty queues an object
+	// create on `resultSchema`. Set, it is a path under the Nextcloud root with
+	// `{field}` placeholders from the planned item, and the run replays as one
+	// POST there, naming the template and the planned item under these keys.
+	resultEndpoint: '',
+	resultTemplateParam: 'templateId',
+	resultPlannedItemParam: 'plannedItem',
 }
 
 /**

package/src/integrations/offline/checklistSubmission.js

@@ -0,0 +1,137 @@
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V. <info@conduction.nl>
+ * SPDX-License-Identifier: EUPL-1.2
+ *
+ * What a finished offline checklist run turns into in the queue.
+ *
+ * Two shapes, chosen by the leaf's `offlineConfig`:
+ *
+ * - `resultEndpoint` empty: an object create on `resultSchema`, the shape the
+ *   leaf has always queued (`inspectionRef`, `checklistTemplateRef`,
+ *   `items[]` with `questionId` / `answer` / `evidenceRefs`).
+ * - `resultEndpoint` set: a `submit` operation that replays the run as ONE
+ *   POST to an app's own endpoint, for an app that stores a run as something
+ *   other than a plain object (a completed task, say) and checks the run
+ *   server side before it stores anything. The endpoint is a path under the
+ *   Nextcloud root with `{field}` placeholders filled from the planned item,
+ *   e.g. `/apps/myapp/api/cases/{caseRef}/checklist-run`.
+ *
+ * Pure: no axios, no IndexedDB, no DOM. The card queues what this returns and
+ * the replay service sends it.
+ *
+ * @module integrations/offline/checklistSubmission
+ */
+
+import { translate as t } from '@nextcloud/l10n'
+
+/**
+ * Fill a `{field}` endpoint template from a planned item.
+ *
+ * Each value is URL-encoded, so a planned item can never steer the request to
+ * another path. A placeholder the item does not fill is an error rather than
+ * an empty path segment: a run sent to the wrong case is worse than one that
+ * waits.
+ *
+ * @param {string} template    The endpoint template.
+ * @param {object} plannedItem The planned item the run belongs to.
+ *
+ * @return {string} The filled path.
+ *
+ * @throws {Error} When a placeholder has no value on the item.
+ */
+export function fillEndpoint(template, plannedItem) {
+	return String(template).replace(/\{([A-Za-z0-9_.]+)\}/g, (match, field) => {
+		const value = field.split('.').reduce((node, key) => (node === null || node === undefined ? undefined : node[key]), plannedItem)
+		if (value === undefined || value === null || String(value) === '') {
+			throw new Error(t('nextcloud-vue', 'This planned item has no {field}, so the answers have nowhere to go.', { field }))
+		}
+		return encodeURIComponent(String(value))
+	})
+}
+
+/**
+ * The id of an object, wherever OpenRegister carries it.
+ *
+ * @param {object|null} object The object.
+ *
+ * @return {string} The id, or an empty string.
+ */
+function idOf(object) {
+	return String(object?.id ?? object?.['@self']?.id ?? object?.uuid ?? '')
+}
+
+/**
+ * Build the queue operation for a finished checklist run.
+ *
+ * @param {object}      config                  The leaf's offline config.
+ * @param {object}      run                     The run.
+ * @param {object}      run.plannedItem         The planned item.
+ * @param {object}      run.template            The normalised template (`items[]`).
+ * @param {object}      run.answers             Map of questionId to `{ answer, evidenceRefs }`.
+ * @param {object|null} [run.gps]               The GPS fix at save, or null.
+ * @param {string}      [run.gpsSource]         `sensor` or `sensorless`.
+ * @param {string}      [run.capturedAt]        ISO time of the save.
+ * @param {boolean}     [run.capturedOffline]   Whether the device was offline at save.
+ *
+ * @return {{ operationType: string, schema: string, endpoint: (string|null), payload: object }}
+ *   The operation fields for `enqueueMutation`.
+ *
+ * @throws {Error} When the endpoint cannot be filled from the planned item.
+ */
+export function buildChecklistSubmission(config, run) {
+	const capturedAt = run.capturedAt || new Date().toISOString()
+	const gpsAtAnswer = run.gps ? { ...run.gps, source: run.gpsSource || 'sensor' } : { source: 'sensorless' }
+	const items = Array.isArray(run.template?.items) ? run.template.items : []
+	const answers = run.answers ?? {}
+	const plannedItemId = idOf(run.plannedItem)
+	const templateId = idOf(run.template)
+
+	if (!config.resultEndpoint) {
+		return {
+			operationType: 'create',
+			schema: config.resultSchema,
+			endpoint: null,
+			payload: {
+				inspectionRef: plannedItemId,
+				checklistTemplateRef: templateId,
+				items: items.map((q) => ({
+					questionId: q.questionId,
+					answer: answers[q.questionId]?.answer,
+					evidenceRefs: answers[q.questionId]?.evidenceRefs ?? [],
+					answeredAt: capturedAt,
+					gpsAtAnswer,
+				})),
+			},
+		}
+	}
+
+	const payload = {
+		[config.resultTemplateParam || 'templateId']: templateId,
+		[config.resultPlannedItemParam || 'plannedItem']: plannedItemId,
+		capturedAt,
+		capturedOffline: run.capturedOffline === true,
+		items: items
+			.filter((q) => {
+				const entry = answers[q.questionId] ?? {}
+				const hasAnswer = entry.answer !== undefined && entry.answer !== null && String(entry.answer).trim() !== ''
+				return hasAnswer || (Array.isArray(entry.evidenceRefs) && entry.evidenceRefs.length > 0)
+			})
+			.map((q) => ({
+				itemId: q.questionId,
+				value: answers[q.questionId]?.answer ?? '',
+				photos: answers[q.questionId]?.evidenceRefs ?? [],
+				answeredAt: capturedAt,
+				gpsAtAnswer,
+			})),
+	}
+	if (run.gps) {
+		payload.location = { ...run.gps, source: run.gpsSource || 'sensor' }
+	}
+
+	return {
+		operationType: 'submit',
+		schema: config.resultSchema || '',
+		endpoint: fillEndpoint(config.resultEndpoint, run.plannedItem),
+		payload,
+	}
+}