@conduction/nextcloud-vue 0.1.0-beta.11 → 0.1.0-beta.12

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (78) hide show
  1. package/dist/nextcloud-vue.cjs +67614 -0
  2. package/dist/nextcloud-vue.cjs.js +13518 -13617
  3. package/dist/nextcloud-vue.cjs.js.map +1 -1
  4. package/dist/nextcloud-vue.cjs.map +1 -0
  5. package/dist/nextcloud-vue.css +1796 -1800
  6. package/dist/nextcloud-vue.esm.js +13518 -13617
  7. package/dist/nextcloud-vue.esm.js.map +1 -1
  8. package/package.json +3 -2
  9. package/src/components/CnActionsBar/CnActionsBar.vue +254 -254
  10. package/src/components/CnAdvancedFormDialog/CnAdvancedFormDialog.vue +570 -570
  11. package/src/components/CnAdvancedFormDialog/CnDataTab.vue +217 -217
  12. package/src/components/CnAdvancedFormDialog/CnMetadataTab.vue +121 -121
  13. package/src/components/CnAdvancedFormDialog/CnPropertiesTab.vue +422 -422
  14. package/src/components/CnAdvancedFormDialog/CnPropertyValueCell.vue +247 -247
  15. package/src/components/CnCard/CnCard.vue +415 -415
  16. package/src/components/CnCardGrid/CnCardGrid.vue +156 -156
  17. package/src/components/CnCellRenderer/CnCellRenderer.vue +132 -132
  18. package/src/components/CnChartWidget/CnChartWidget.vue +346 -346
  19. package/src/components/CnConfigurationCard/CnConfigurationCard.vue +77 -77
  20. package/src/components/CnContextMenu/CnContextMenu.vue +142 -142
  21. package/src/components/CnCopyDialog/CnCopyDialog.vue +266 -266
  22. package/src/components/CnDashboardGrid/CnDashboardGrid.vue +229 -229
  23. package/src/components/CnDashboardPage/CnDashboardPage.vue +397 -397
  24. package/src/components/CnDataTable/CnDataTable.vue +362 -362
  25. package/src/components/CnDeleteDialog/CnDeleteDialog.vue +177 -177
  26. package/src/components/CnDetailCard/CnDetailCard.vue +225 -225
  27. package/src/components/CnDetailGrid/CnDetailGrid.vue +256 -256
  28. package/src/components/CnDetailPage/CnDetailPage.vue +432 -432
  29. package/src/components/CnFacetSidebar/CnFacetSidebar.vue +234 -234
  30. package/src/components/CnFilterBar/CnFilterBar.vue +153 -153
  31. package/src/components/CnFormDialog/CnFormDialog.vue +1047 -1047
  32. package/src/components/CnIcon/CnIcon.vue +89 -89
  33. package/src/components/CnIndexPage/CnIndexPage.vue +981 -980
  34. package/src/components/CnIndexSidebar/CnIndexSidebar.vue +536 -536
  35. package/src/components/CnInfoWidget/CnInfoWidget.vue +219 -219
  36. package/src/components/CnItemCard/CnItemCard.vue +134 -134
  37. package/src/components/CnJsonViewer/CnJsonViewer.vue +312 -312
  38. package/src/components/CnKpiGrid/CnKpiGrid.vue +93 -93
  39. package/src/components/CnMassActionBar/CnMassActionBar.vue +161 -161
  40. package/src/components/CnMassCopyDialog/CnMassCopyDialog.vue +327 -327
  41. package/src/components/CnMassDeleteDialog/CnMassDeleteDialog.vue +245 -245
  42. package/src/components/CnMassExportDialog/CnMassExportDialog.vue +191 -191
  43. package/src/components/CnMassImportDialog/CnMassImportDialog.vue +494 -494
  44. package/src/components/CnNoteCard/CnNoteCard.vue +149 -149
  45. package/src/components/CnNotesCard/CnNotesCard.vue +416 -416
  46. package/src/components/CnObjectCard/CnObjectCard.vue +294 -294
  47. package/src/components/CnObjectDataWidget/CnObjectDataWidget.vue +854 -854
  48. package/src/components/CnObjectMetadataWidget/CnObjectMetadataWidget.vue +289 -289
  49. package/src/components/CnObjectSidebar/CnAuditTrailTab.vue +369 -369
  50. package/src/components/CnObjectSidebar/CnFilesTab.vue +287 -287
  51. package/src/components/CnObjectSidebar/CnNotesTab.vue +250 -250
  52. package/src/components/CnObjectSidebar/CnObjectSidebar.vue +255 -255
  53. package/src/components/CnObjectSidebar/CnTagsTab.vue +259 -259
  54. package/src/components/CnObjectSidebar/CnTasksTab.vue +483 -483
  55. package/src/components/CnPageHeader/CnPageHeader.vue +61 -61
  56. package/src/components/CnPagination/CnPagination.vue +253 -253
  57. package/src/components/CnProgressBar/CnProgressBar.vue +262 -262
  58. package/src/components/CnRegisterMapping/CnRegisterMapping.vue +793 -793
  59. package/src/components/CnRowActions/CnRowActions.vue +95 -95
  60. package/src/components/CnSchemaFormDialog/CnSchemaConfigurationTab.vue +226 -226
  61. package/src/components/CnSchemaFormDialog/CnSchemaFormDialog.vue +788 -788
  62. package/src/components/CnSchemaFormDialog/CnSchemaPropertiesTab.vue +305 -305
  63. package/src/components/CnSchemaFormDialog/CnSchemaPropertyActions.vue +1398 -1398
  64. package/src/components/CnSchemaFormDialog/CnSchemaSecurityTab.vue +236 -236
  65. package/src/components/CnSettingsCard/CnSettingsCard.vue +92 -92
  66. package/src/components/CnSettingsSection/CnSettingsSection.vue +267 -267
  67. package/src/components/CnStatsBlock/CnStatsBlock.vue +437 -437
  68. package/src/components/CnStatsPanel/CnStatsPanel.vue +321 -321
  69. package/src/components/CnStatusBadge/CnStatusBadge.vue +90 -90
  70. package/src/components/CnTabbedFormDialog/CnTabbedFormDialog.vue +545 -545
  71. package/src/components/CnTableWidget/CnTableWidget.vue +333 -333
  72. package/src/components/CnTasksCard/CnTasksCard.vue +374 -374
  73. package/src/components/CnTileWidget/CnTileWidget.vue +159 -159
  74. package/src/components/CnTimelineStages/CnTimelineStages.vue +294 -294
  75. package/src/components/CnUserActionMenu/CnUserActionMenu.vue +436 -436
  76. package/src/components/CnVersionInfoCard/CnVersionInfoCard.vue +313 -313
  77. package/src/components/CnWidgetRenderer/CnWidgetRenderer.vue +180 -180
  78. package/src/components/CnWidgetWrapper/CnWidgetWrapper.vue +248 -248
@@ -1,397 +1,397 @@
1
- <!--
2
- CnDashboardPage — Top-level dashboard page with GridStack widget grid.
3
-
4
- The dashboard equivalent of CnIndexPage. Assembles a complete dashboard
5
- from a widget definition array and a layout array. Supports:
6
- - Custom widgets via scoped slots (#widget-{widgetId})
7
- - Nextcloud Dashboard API widgets (auto-rendered)
8
- - Tile widgets (quick-access links)
9
- - Drag-and-drop editing mode
10
- - Header with title, actions, and edit toggle
11
- -->
12
- <template>
13
- <div class="cn-dashboard-page">
14
- <!-- Header -->
15
- <div class="cn-dashboard-page__header">
16
- <div class="cn-dashboard-page__header-left">
17
- <h2 v-if="title" class="cn-dashboard-page__title">
18
- {{ title }}
19
- </h2>
20
- <p v-if="description" class="cn-dashboard-page__description">
21
- {{ description }}
22
- </p>
23
- </div>
24
- <div class="cn-dashboard-page__header-actions">
25
- <slot name="actions" />
26
- <NcButton
27
- v-if="allowEdit"
28
- :type="isEditing ? 'primary' : 'secondary'"
29
- @click="toggleEdit">
30
- <template #icon>
31
- <Pencil v-if="!isEditing" :size="20" />
32
- <Check v-else :size="20" />
33
- </template>
34
- {{ isEditing ? doneLabel : editLabel }}
35
- </NcButton>
36
- </div>
37
- </div>
38
-
39
- <!-- Loading state -->
40
- <NcLoadingIcon v-if="loading" />
41
-
42
- <!-- Empty state -->
43
- <div v-else-if="!hasWidgets" class="cn-dashboard-page__empty">
44
- <slot name="empty">
45
- <NcEmptyContent :description="emptyLabel">
46
- <template #icon>
47
- <ViewDashboardOutline :size="48" />
48
- </template>
49
- </NcEmptyContent>
50
- </slot>
51
- </div>
52
-
53
- <!-- Dashboard grid -->
54
- <CnDashboardGrid
55
- v-else
56
- :layout="layout"
57
- :editable="isEditing"
58
- :columns="columns"
59
- :cell-height="cellHeight"
60
- :margin="gridMargin"
61
- @layout-change="onLayoutChange">
62
- <template #widget="{ item }">
63
- <!-- Tile widget -->
64
- <CnTileWidget
65
- v-if="isTile(item)"
66
- :tile="getTileConfig(item)" />
67
-
68
- <!-- Custom slot widget — apps provide their own rendering -->
69
- <template v-else-if="hasWidgetSlot(item.widgetId)">
70
- <CnWidgetWrapper
71
- :title="getWidgetTitle(item)"
72
- :icon-url="getWidgetIconUrl(item)"
73
- :icon-class="getWidgetIconClass(item)"
74
- :show-title="item.showTitle !== false"
75
- :borderless="item.showTitle === false"
76
- :flush="item.flush === true"
77
- :buttons="getWidgetButtons(item)"
78
- :style-config="item.styleConfig || {}">
79
- <!-- Per-widget header actions (e.g. #widget-my-work-actions) -->
80
- <template v-if="$slots['widget-' + item.widgetId + '-actions']" #actions>
81
- <slot :name="'widget-' + item.widgetId + '-actions'" :item="item" :widget="getWidgetDef(item.widgetId)" />
82
- </template>
83
- <slot :name="'widget-' + item.widgetId" :item="item" :widget="getWidgetDef(item.widgetId)" />
84
- </CnWidgetWrapper>
85
- </template>
86
-
87
- <!-- NC Dashboard API widget -->
88
- <template v-else-if="isNcWidget(item)">
89
- <CnWidgetWrapper
90
- :title="getWidgetTitle(item)"
91
- :icon-url="getWidgetIconUrl(item)"
92
- :icon-class="getWidgetIconClass(item)"
93
- :show-title="item.showTitle !== false"
94
- :buttons="getWidgetButtons(item)"
95
- :style-config="item.styleConfig || {}">
96
- <CnWidgetRenderer
97
- :widget="getWidgetDef(item.widgetId)"
98
- :unavailable-text="unavailableLabel" />
99
- </CnWidgetWrapper>
100
- </template>
101
-
102
- <!-- Unknown widget fallback -->
103
- <CnWidgetWrapper
104
- v-else
105
- :title="getWidgetTitle(item)"
106
- :show-title="item.showTitle !== false">
107
- <div class="cn-dashboard-page__unknown">
108
- {{ unavailableLabel }}
109
- </div>
110
- </CnWidgetWrapper>
111
- </template>
112
- </CnDashboardGrid>
113
- </div>
114
- </template>
115
-
116
- <script>
117
- import { translate as t } from '@nextcloud/l10n'
118
- import { NcButton, NcEmptyContent, NcLoadingIcon } from '@nextcloud/vue'
119
- import Pencil from 'vue-material-design-icons/Pencil.vue'
120
- import Check from 'vue-material-design-icons/Check.vue'
121
- import ViewDashboardOutline from 'vue-material-design-icons/ViewDashboardOutline.vue'
122
- import CnDashboardGrid from '../CnDashboardGrid/CnDashboardGrid.vue'
123
- import CnWidgetWrapper from '../CnWidgetWrapper/CnWidgetWrapper.vue'
124
- import CnWidgetRenderer from '../CnWidgetRenderer/CnWidgetRenderer.vue'
125
- import CnTileWidget from '../CnTileWidget/CnTileWidget.vue'
126
-
127
- /**
128
- * CnDashboardPage — Top-level dashboard page component.
129
- *
130
- * The dashboard equivalent of CnIndexPage. Renders a configurable grid
131
- * of widgets from a `widgets` definition array and a `layout` array.
132
- *
133
- * Widget types:
134
- * 1. **Custom** — App provides rendering via `#widget-{widgetId}` slot
135
- * 2. **NC Dashboard API** — Widgets with `itemApiVersions` are auto-rendered
136
- * 3. **Tile** — Items with `type: 'tile'` render as quick-access tiles
137
- *
138
- * @example Basic usage with custom widgets
139
- * <CnDashboardPage
140
- * title="Dashboard"
141
- * :widgets="widgetDefs"
142
- * :layout="savedLayout"
143
- * @layout-change="saveLayout">
144
- * <template #widget-cases-by-status="{ item }">
145
- * <StatusChart :data="statusData" />
146
- * </template>
147
- * <template #widget-my-work="{ item }">
148
- * <MyWorkList :items="workItems" />
149
- * </template>
150
- * </CnDashboardPage>
151
- *
152
- * @example With NC Dashboard API widgets
153
- * <CnDashboardPage
154
- * title="Dashboard"
155
- * :widgets="[...appWidgets, ...ncWidgets]"
156
- * :layout="layout"
157
- * @layout-change="saveLayout" />
158
- */
159
- export default {
160
- name: 'CnDashboardPage',
161
-
162
- components: {
163
- NcButton,
164
- NcEmptyContent,
165
- NcLoadingIcon,
166
- Pencil,
167
- Check,
168
- ViewDashboardOutline,
169
- CnDashboardGrid,
170
- CnWidgetWrapper,
171
- CnWidgetRenderer,
172
- CnTileWidget,
173
- },
174
-
175
- props: {
176
- /** Page title */
177
- title: {
178
- type: String,
179
- default: '',
180
- },
181
- /** Page description (shown below title) */
182
- description: {
183
- type: String,
184
- default: '',
185
- },
186
- /**
187
- * Widget definitions array. Each widget defines metadata for rendering.
188
- *
189
- * Custom widgets: `{ id: 'my-widget', title: 'My Widget', type: 'custom' }`
190
- * NC API widgets: `{ id: 'calendar', title: 'Calendar', itemApiVersions: [1,2], ... }`
191
- * Tile widgets: `{ id: 'tile-files', type: 'tile', title: 'Files', icon: 'M12...', iconType: 'svg', backgroundColor: '#0082c9', textColor: '#fff', linkType: 'app', linkValue: 'files' }`
192
- *
193
- * @type {Array<{ id: string, title: string, type?: string, iconUrl?: string, iconClass?: string, buttons?: Array, itemApiVersions?: number[], reloadInterval?: number, [key: string]: any }>}
194
- */
195
- widgets: {
196
- type: Array,
197
- default: () => [],
198
- },
199
- /**
200
- * Layout array defining widget positions in the grid.
201
- *
202
- * Each item: `{ id: 'unique-id', widgetId: 'my-widget', gridX: 0, gridY: 0, gridWidth: 4, gridHeight: 3 }`
203
- *
204
- * Additional properties (showTitle, styleConfig, tile config) are passed through.
205
- *
206
- * @type {Array<{ id: string|number, widgetId: string, gridX: number, gridY: number, gridWidth: number, gridHeight: number, showTitle?: boolean, styleConfig?: object, [key: string]: any }>}
207
- */
208
- layout: {
209
- type: Array,
210
- default: () => [],
211
- },
212
- /** Whether the dashboard is loading */
213
- loading: {
214
- type: Boolean,
215
- default: false,
216
- },
217
- /** Whether to show the edit toggle button */
218
- allowEdit: {
219
- type: Boolean,
220
- default: false,
221
- },
222
- /** Number of grid columns */
223
- columns: {
224
- type: Number,
225
- default: 12,
226
- },
227
- /** Grid cell height in pixels */
228
- cellHeight: {
229
- type: Number,
230
- default: 80,
231
- },
232
- /** Grid margin in pixels */
233
- gridMargin: {
234
- type: Number,
235
- default: 12,
236
- },
237
- /** Label for the edit button */
238
- editLabel: {
239
- type: String,
240
- default: () => t('nextcloud-vue', 'Edit'),
241
- },
242
- /** Label for the done button (when editing) */
243
- doneLabel: {
244
- type: String,
245
- default: () => t('nextcloud-vue', 'Done'),
246
- },
247
- /** Label for the empty state */
248
- emptyLabel: {
249
- type: String,
250
- default: () => t('nextcloud-vue', 'No widgets configured'),
251
- },
252
- /** Label for unavailable widgets */
253
- unavailableLabel: {
254
- type: String,
255
- default: () => t('nextcloud-vue', 'Widget not available'),
256
- },
257
- },
258
-
259
- emits: ['layout-change', 'edit-toggle'],
260
-
261
- data() {
262
- return {
263
- isEditing: false,
264
- }
265
- },
266
-
267
- computed: {
268
- hasWidgets() {
269
- return this.layout.length > 0
270
- },
271
-
272
- widgetMap() {
273
- const map = {}
274
- for (const w of this.widgets) {
275
- map[w.id] = w
276
- }
277
- return map
278
- },
279
- },
280
-
281
- methods: {
282
- toggleEdit() {
283
- this.isEditing = !this.isEditing
284
- this.$emit('edit-toggle', this.isEditing)
285
- },
286
-
287
- onLayoutChange(updated) {
288
- this.$emit('layout-change', updated)
289
- },
290
-
291
- getWidgetDef(widgetId) {
292
- return this.widgetMap[widgetId] || null
293
- },
294
-
295
- getWidgetTitle(item) {
296
- const def = this.getWidgetDef(item.widgetId)
297
- return item.customTitle || def?.title || item.widgetId
298
- },
299
-
300
- getWidgetIconUrl(item) {
301
- const def = this.getWidgetDef(item.widgetId)
302
- return def?.iconUrl || null
303
- },
304
-
305
- getWidgetIconClass(item) {
306
- const def = this.getWidgetDef(item.widgetId)
307
- return def?.iconClass || null
308
- },
309
-
310
- getWidgetButtons(item) {
311
- const def = this.getWidgetDef(item.widgetId)
312
- return def?.buttons || []
313
- },
314
-
315
- isTile(item) {
316
- const def = this.getWidgetDef(item.widgetId)
317
- return def?.type === 'tile'
318
- },
319
-
320
- getTileConfig(item) {
321
- const def = this.getWidgetDef(item.widgetId)
322
- if (!def) return null
323
- return {
324
- title: def.title,
325
- icon: def.icon,
326
- iconType: def.iconType,
327
- backgroundColor: def.backgroundColor,
328
- textColor: def.textColor,
329
- linkType: def.linkType,
330
- linkValue: def.linkValue,
331
- }
332
- },
333
-
334
- isNcWidget(item) {
335
- const def = this.getWidgetDef(item.widgetId)
336
- return def?.itemApiVersions && def.itemApiVersions.length > 0
337
- },
338
-
339
- hasWidgetSlot(widgetId) {
340
- return !!this.$scopedSlots['widget-' + widgetId]
341
- },
342
- },
343
- }
344
- </script>
345
-
346
- <style scoped>
347
- .cn-dashboard-page {
348
- padding: 20px;
349
- max-width: 1400px;
350
- }
351
-
352
- .cn-dashboard-page__header {
353
- display: flex;
354
- justify-content: space-between;
355
- align-items: flex-start;
356
- margin-bottom: 20px;
357
- flex-wrap: wrap;
358
- gap: 12px;
359
- }
360
-
361
- .cn-dashboard-page__header-left {
362
- min-width: 0;
363
- }
364
-
365
- .cn-dashboard-page__title {
366
- margin: 0;
367
- font-size: 20px;
368
- font-weight: 700;
369
- }
370
-
371
- .cn-dashboard-page__description {
372
- margin: 4px 0 0;
373
- font-size: 14px;
374
- color: var(--color-text-maxcontrast);
375
- }
376
-
377
- .cn-dashboard-page__header-actions {
378
- display: flex;
379
- gap: 8px;
380
- flex-wrap: wrap;
381
- flex-shrink: 0;
382
- }
383
-
384
- .cn-dashboard-page__empty {
385
- padding: 60px 20px;
386
- }
387
-
388
- .cn-dashboard-page__unknown {
389
- display: flex;
390
- align-items: center;
391
- justify-content: center;
392
- height: 100%;
393
- color: var(--color-text-maxcontrast);
394
- font-size: 14px;
395
- padding: 16px;
396
- }
397
- </style>
1
+ <!--
2
+ CnDashboardPage — Top-level dashboard page with GridStack widget grid.
3
+
4
+ The dashboard equivalent of CnIndexPage. Assembles a complete dashboard
5
+ from a widget definition array and a layout array. Supports:
6
+ - Custom widgets via scoped slots (#widget-{widgetId})
7
+ - Nextcloud Dashboard API widgets (auto-rendered)
8
+ - Tile widgets (quick-access links)
9
+ - Drag-and-drop editing mode
10
+ - Header with title, actions, and edit toggle
11
+ -->
12
+ <template>
13
+ <div class="cn-dashboard-page">
14
+ <!-- Header -->
15
+ <div class="cn-dashboard-page__header">
16
+ <div class="cn-dashboard-page__header-left">
17
+ <h2 v-if="title" class="cn-dashboard-page__title">
18
+ {{ title }}
19
+ </h2>
20
+ <p v-if="description" class="cn-dashboard-page__description">
21
+ {{ description }}
22
+ </p>
23
+ </div>
24
+ <div class="cn-dashboard-page__header-actions">
25
+ <slot name="actions" />
26
+ <NcButton
27
+ v-if="allowEdit"
28
+ :type="isEditing ? 'primary' : 'secondary'"
29
+ @click="toggleEdit">
30
+ <template #icon>
31
+ <Pencil v-if="!isEditing" :size="20" />
32
+ <Check v-else :size="20" />
33
+ </template>
34
+ {{ isEditing ? doneLabel : editLabel }}
35
+ </NcButton>
36
+ </div>
37
+ </div>
38
+
39
+ <!-- Loading state -->
40
+ <NcLoadingIcon v-if="loading" />
41
+
42
+ <!-- Empty state -->
43
+ <div v-else-if="!hasWidgets" class="cn-dashboard-page__empty">
44
+ <slot name="empty">
45
+ <NcEmptyContent :description="emptyLabel">
46
+ <template #icon>
47
+ <ViewDashboardOutline :size="48" />
48
+ </template>
49
+ </NcEmptyContent>
50
+ </slot>
51
+ </div>
52
+
53
+ <!-- Dashboard grid -->
54
+ <CnDashboardGrid
55
+ v-else
56
+ :layout="layout"
57
+ :editable="isEditing"
58
+ :columns="columns"
59
+ :cell-height="cellHeight"
60
+ :margin="gridMargin"
61
+ @layout-change="onLayoutChange">
62
+ <template #widget="{ item }">
63
+ <!-- Tile widget -->
64
+ <CnTileWidget
65
+ v-if="isTile(item)"
66
+ :tile="getTileConfig(item)" />
67
+
68
+ <!-- Custom slot widget — apps provide their own rendering -->
69
+ <template v-else-if="hasWidgetSlot(item.widgetId)">
70
+ <CnWidgetWrapper
71
+ :title="getWidgetTitle(item)"
72
+ :icon-url="getWidgetIconUrl(item)"
73
+ :icon-class="getWidgetIconClass(item)"
74
+ :show-title="item.showTitle !== false"
75
+ :borderless="item.showTitle === false"
76
+ :flush="item.flush === true"
77
+ :buttons="getWidgetButtons(item)"
78
+ :style-config="item.styleConfig || {}">
79
+ <!-- Per-widget header actions (e.g. #widget-my-work-actions) -->
80
+ <template v-if="$slots['widget-' + item.widgetId + '-actions']" #actions>
81
+ <slot :name="'widget-' + item.widgetId + '-actions'" :item="item" :widget="getWidgetDef(item.widgetId)" />
82
+ </template>
83
+ <slot :name="'widget-' + item.widgetId" :item="item" :widget="getWidgetDef(item.widgetId)" />
84
+ </CnWidgetWrapper>
85
+ </template>
86
+
87
+ <!-- NC Dashboard API widget -->
88
+ <template v-else-if="isNcWidget(item)">
89
+ <CnWidgetWrapper
90
+ :title="getWidgetTitle(item)"
91
+ :icon-url="getWidgetIconUrl(item)"
92
+ :icon-class="getWidgetIconClass(item)"
93
+ :show-title="item.showTitle !== false"
94
+ :buttons="getWidgetButtons(item)"
95
+ :style-config="item.styleConfig || {}">
96
+ <CnWidgetRenderer
97
+ :widget="getWidgetDef(item.widgetId)"
98
+ :unavailable-text="unavailableLabel" />
99
+ </CnWidgetWrapper>
100
+ </template>
101
+
102
+ <!-- Unknown widget fallback -->
103
+ <CnWidgetWrapper
104
+ v-else
105
+ :title="getWidgetTitle(item)"
106
+ :show-title="item.showTitle !== false">
107
+ <div class="cn-dashboard-page__unknown">
108
+ {{ unavailableLabel }}
109
+ </div>
110
+ </CnWidgetWrapper>
111
+ </template>
112
+ </CnDashboardGrid>
113
+ </div>
114
+ </template>
115
+
116
+ <script>
117
+ import { translate as t } from '@nextcloud/l10n'
118
+ import { NcButton, NcEmptyContent, NcLoadingIcon } from '@nextcloud/vue'
119
+ import Pencil from 'vue-material-design-icons/Pencil.vue'
120
+ import Check from 'vue-material-design-icons/Check.vue'
121
+ import ViewDashboardOutline from 'vue-material-design-icons/ViewDashboardOutline.vue'
122
+ import CnDashboardGrid from '../CnDashboardGrid/CnDashboardGrid.vue'
123
+ import CnWidgetWrapper from '../CnWidgetWrapper/CnWidgetWrapper.vue'
124
+ import CnWidgetRenderer from '../CnWidgetRenderer/CnWidgetRenderer.vue'
125
+ import CnTileWidget from '../CnTileWidget/CnTileWidget.vue'
126
+
127
+ /**
128
+ * CnDashboardPage — Top-level dashboard page component.
129
+ *
130
+ * The dashboard equivalent of CnIndexPage. Renders a configurable grid
131
+ * of widgets from a `widgets` definition array and a `layout` array.
132
+ *
133
+ * Widget types:
134
+ * 1. **Custom** — App provides rendering via `#widget-{widgetId}` slot
135
+ * 2. **NC Dashboard API** — Widgets with `itemApiVersions` are auto-rendered
136
+ * 3. **Tile** — Items with `type: 'tile'` render as quick-access tiles
137
+ *
138
+ * @example Basic usage with custom widgets
139
+ * <CnDashboardPage
140
+ * title="Dashboard"
141
+ * :widgets="widgetDefs"
142
+ * :layout="savedLayout"
143
+ * @layout-change="saveLayout">
144
+ * <template #widget-cases-by-status="{ item }">
145
+ * <StatusChart :data="statusData" />
146
+ * </template>
147
+ * <template #widget-my-work="{ item }">
148
+ * <MyWorkList :items="workItems" />
149
+ * </template>
150
+ * </CnDashboardPage>
151
+ *
152
+ * @example With NC Dashboard API widgets
153
+ * <CnDashboardPage
154
+ * title="Dashboard"
155
+ * :widgets="[...appWidgets, ...ncWidgets]"
156
+ * :layout="layout"
157
+ * @layout-change="saveLayout" />
158
+ */
159
+ export default {
160
+ name: 'CnDashboardPage',
161
+
162
+ components: {
163
+ NcButton,
164
+ NcEmptyContent,
165
+ NcLoadingIcon,
166
+ Pencil,
167
+ Check,
168
+ ViewDashboardOutline,
169
+ CnDashboardGrid,
170
+ CnWidgetWrapper,
171
+ CnWidgetRenderer,
172
+ CnTileWidget,
173
+ },
174
+
175
+ props: {
176
+ /** Page title */
177
+ title: {
178
+ type: String,
179
+ default: '',
180
+ },
181
+ /** Page description (shown below title) */
182
+ description: {
183
+ type: String,
184
+ default: '',
185
+ },
186
+ /**
187
+ * Widget definitions array. Each widget defines metadata for rendering.
188
+ *
189
+ * Custom widgets: `{ id: 'my-widget', title: 'My Widget', type: 'custom' }`
190
+ * NC API widgets: `{ id: 'calendar', title: 'Calendar', itemApiVersions: [1,2], ... }`
191
+ * Tile widgets: `{ id: 'tile-files', type: 'tile', title: 'Files', icon: 'M12...', iconType: 'svg', backgroundColor: '#0082c9', textColor: '#fff', linkType: 'app', linkValue: 'files' }`
192
+ *
193
+ * @type {Array<{ id: string, title: string, type?: string, iconUrl?: string, iconClass?: string, buttons?: Array, itemApiVersions?: number[], reloadInterval?: number, [key: string]: any }>}
194
+ */
195
+ widgets: {
196
+ type: Array,
197
+ default: () => [],
198
+ },
199
+ /**
200
+ * Layout array defining widget positions in the grid.
201
+ *
202
+ * Each item: `{ id: 'unique-id', widgetId: 'my-widget', gridX: 0, gridY: 0, gridWidth: 4, gridHeight: 3 }`
203
+ *
204
+ * Additional properties (showTitle, styleConfig, tile config) are passed through.
205
+ *
206
+ * @type {Array<{ id: string|number, widgetId: string, gridX: number, gridY: number, gridWidth: number, gridHeight: number, showTitle?: boolean, styleConfig?: object, [key: string]: any }>}
207
+ */
208
+ layout: {
209
+ type: Array,
210
+ default: () => [],
211
+ },
212
+ /** Whether the dashboard is loading */
213
+ loading: {
214
+ type: Boolean,
215
+ default: false,
216
+ },
217
+ /** Whether to show the edit toggle button */
218
+ allowEdit: {
219
+ type: Boolean,
220
+ default: false,
221
+ },
222
+ /** Number of grid columns */
223
+ columns: {
224
+ type: Number,
225
+ default: 12,
226
+ },
227
+ /** Grid cell height in pixels */
228
+ cellHeight: {
229
+ type: Number,
230
+ default: 80,
231
+ },
232
+ /** Grid margin in pixels */
233
+ gridMargin: {
234
+ type: Number,
235
+ default: 12,
236
+ },
237
+ /** Label for the edit button */
238
+ editLabel: {
239
+ type: String,
240
+ default: () => t('nextcloud-vue', 'Edit'),
241
+ },
242
+ /** Label for the done button (when editing) */
243
+ doneLabel: {
244
+ type: String,
245
+ default: () => t('nextcloud-vue', 'Done'),
246
+ },
247
+ /** Label for the empty state */
248
+ emptyLabel: {
249
+ type: String,
250
+ default: () => t('nextcloud-vue', 'No widgets configured'),
251
+ },
252
+ /** Label for unavailable widgets */
253
+ unavailableLabel: {
254
+ type: String,
255
+ default: () => t('nextcloud-vue', 'Widget not available'),
256
+ },
257
+ },
258
+
259
+ emits: ['layout-change', 'edit-toggle'],
260
+
261
+ data() {
262
+ return {
263
+ isEditing: false,
264
+ }
265
+ },
266
+
267
+ computed: {
268
+ hasWidgets() {
269
+ return this.layout.length > 0
270
+ },
271
+
272
+ widgetMap() {
273
+ const map = {}
274
+ for (const w of this.widgets) {
275
+ map[w.id] = w
276
+ }
277
+ return map
278
+ },
279
+ },
280
+
281
+ methods: {
282
+ toggleEdit() {
283
+ this.isEditing = !this.isEditing
284
+ this.$emit('edit-toggle', this.isEditing)
285
+ },
286
+
287
+ onLayoutChange(updated) {
288
+ this.$emit('layout-change', updated)
289
+ },
290
+
291
+ getWidgetDef(widgetId) {
292
+ return this.widgetMap[widgetId] || null
293
+ },
294
+
295
+ getWidgetTitle(item) {
296
+ const def = this.getWidgetDef(item.widgetId)
297
+ return item.customTitle || def?.title || item.widgetId
298
+ },
299
+
300
+ getWidgetIconUrl(item) {
301
+ const def = this.getWidgetDef(item.widgetId)
302
+ return def?.iconUrl || null
303
+ },
304
+
305
+ getWidgetIconClass(item) {
306
+ const def = this.getWidgetDef(item.widgetId)
307
+ return def?.iconClass || null
308
+ },
309
+
310
+ getWidgetButtons(item) {
311
+ const def = this.getWidgetDef(item.widgetId)
312
+ return def?.buttons || []
313
+ },
314
+
315
+ isTile(item) {
316
+ const def = this.getWidgetDef(item.widgetId)
317
+ return def?.type === 'tile'
318
+ },
319
+
320
+ getTileConfig(item) {
321
+ const def = this.getWidgetDef(item.widgetId)
322
+ if (!def) return null
323
+ return {
324
+ title: def.title,
325
+ icon: def.icon,
326
+ iconType: def.iconType,
327
+ backgroundColor: def.backgroundColor,
328
+ textColor: def.textColor,
329
+ linkType: def.linkType,
330
+ linkValue: def.linkValue,
331
+ }
332
+ },
333
+
334
+ isNcWidget(item) {
335
+ const def = this.getWidgetDef(item.widgetId)
336
+ return def?.itemApiVersions && def.itemApiVersions.length > 0
337
+ },
338
+
339
+ hasWidgetSlot(widgetId) {
340
+ return !!this.$scopedSlots['widget-' + widgetId]
341
+ },
342
+ },
343
+ }
344
+ </script>
345
+
346
+ <style scoped>
347
+ .cn-dashboard-page {
348
+ padding: 20px;
349
+ max-width: 1400px;
350
+ }
351
+
352
+ .cn-dashboard-page__header {
353
+ display: flex;
354
+ justify-content: space-between;
355
+ align-items: flex-start;
356
+ margin-bottom: 20px;
357
+ flex-wrap: wrap;
358
+ gap: 12px;
359
+ }
360
+
361
+ .cn-dashboard-page__header-left {
362
+ min-width: 0;
363
+ }
364
+
365
+ .cn-dashboard-page__title {
366
+ margin: 0;
367
+ font-size: 20px;
368
+ font-weight: 700;
369
+ }
370
+
371
+ .cn-dashboard-page__description {
372
+ margin: 4px 0 0;
373
+ font-size: 14px;
374
+ color: var(--color-text-maxcontrast);
375
+ }
376
+
377
+ .cn-dashboard-page__header-actions {
378
+ display: flex;
379
+ gap: 8px;
380
+ flex-wrap: wrap;
381
+ flex-shrink: 0;
382
+ }
383
+
384
+ .cn-dashboard-page__empty {
385
+ padding: 60px 20px;
386
+ }
387
+
388
+ .cn-dashboard-page__unknown {
389
+ display: flex;
390
+ align-items: center;
391
+ justify-content: center;
392
+ height: 100%;
393
+ color: var(--color-text-maxcontrast);
394
+ font-size: 14px;
395
+ padding: 16px;
396
+ }
397
+ </style>