@conduction/nextcloud-vue 2.89.1 → 2.90.0

package/dist/esm/nextcloud-vue.css

@@ -34796,28 +34796,28 @@ to {
 }
 
 
-.cn-admin-settings-shell[data-v-c3ceda64] {
+.cn-admin-settings-shell[data-v-038f200a] {
 	max-width: 900px;
 }
 
 /* The board look lifts the width and lays the header and cards on a grid (look-board.css). */
-.cn-support-info[data-v-c3ceda64] {
+.cn-support-info[data-v-038f200a] {
 	margin-top: 16px;
 	padding-top: 16px;
 	border-top: 1px solid var(--color-border);
 }
-.cn-support-info h4[data-v-c3ceda64] {
+.cn-support-info h4[data-v-038f200a] {
 	margin: 0 0 8px 0;
 	font-size: 14px;
 	font-weight: 600;
 	color: var(--color-main-text);
 }
-.cn-support-info p[data-v-c3ceda64] {
+.cn-support-info p[data-v-038f200a] {
 	margin: 4px 0;
 	color: var(--color-text-maxcontrast);
 	font-size: 14px;
 }
-.cn-support-info a[data-v-c3ceda64] {
+.cn-support-info a[data-v-038f200a] {
 	color: var(--color-primary-element);
 }
 
@@ -38141,17 +38141,17 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 }
 
 
-.cn-dashboard-grid[data-v-a91998fc] {
+.cn-dashboard-grid[data-v-a76b6fc6] {
 	width: 100%;
 	min-height: 200px;
 }
-.grid-stack[data-v-a91998fc] {
+.grid-stack[data-v-a76b6fc6] {
 	background: transparent;
 }
 
 /* Screen-reader-only text: the keyboard key map and the live region. Kept in
    the layout (not `display: none`) so assistive tech still reads it. */
-.cn-dashboard-grid__sr-only[data-v-a91998fc] {
+.cn-dashboard-grid__sr-only[data-v-a76b6fc6] {
 	position: absolute;
 	width: 1px;
 	height: 1px;
@@ -38166,7 +38166,7 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 /* Grid items become tab stops in edit mode — give them a visible focus ring
    that satisfies WCAG 2.1 SC 2.4.7 without relying on the widget's own
    styling. `outline-offset` keeps the ring outside the rounded card. */
-.grid-stack-item[data-v-a91998fc]:focus-visible {
+.grid-stack-item[data-v-a76b6fc6]:focus-visible {
 	outline: 2px solid var(--color-primary-element, #0082c9);
 	outline-offset: 2px;
 	border-radius: var(--border-radius-container-large, 16px);
@@ -38178,19 +38178,19 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
    cell never shrank: "Waiting for me" stayed a tall card around one row. In
    such a cell the child takes its own height. A cell without the key keeps
    the filling child. */
-.cn-dashboard-grid__item--fit[data-v-a91998fc] >  .grid-stack-item-content > * {
+.cn-dashboard-grid__item--fit[data-v-a76b6fc6] >  .grid-stack-item-content > * {
 	height: auto;
 }
-[data-v-a91998fc] .grid-stack-item-content {
+[data-v-a76b6fc6] .grid-stack-item-content {
 	background: var(--color-main-background);
 	border: none;
 	box-shadow: none;
 	overflow: hidden;
 }
-[data-v-a91998fc] .grid-stack-item-content:has(.cn-widget-wrapper--borderless) {
+[data-v-a76b6fc6] .grid-stack-item-content:has(.cn-widget-wrapper--borderless) {
 	background: transparent;
 }
-[data-v-a91998fc] .grid-stack-placeholder > .placeholder-content {
+[data-v-a76b6fc6] .grid-stack-placeholder > .placeholder-content {
 	background: var(--color-primary-element-light);
 	border: 2px dashed var(--color-primary-element);
 	border-radius: var(--border-radius-large);
@@ -38458,7 +38458,7 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 }
 
 
-.cn-dashboard-page[data-v-20ca81f3] {
+.cn-dashboard-page[data-v-42bc14a4] {
 	padding: 20px;
 	max-width: 1800px;
 	/* Centre the leftover space once the cap engages, so a wide screen shows
@@ -38472,7 +38472,7 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 	overflow-y: auto;
 	box-sizing: border-box;
 }
-.cn-dashboard-page__header[data-v-20ca81f3] {
+.cn-dashboard-page__header[data-v-42bc14a4] {
 	display: flex;
 	justify-content: space-between;
 	align-items: flex-start;
@@ -38484,21 +38484,21 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 	   room. Only the HEADER shifts right — body widgets keep full width. */
 	padding-inline-start: 56px;
 }
-.cn-dashboard-page__header-left[data-v-20ca81f3] {
+.cn-dashboard-page__header-left[data-v-42bc14a4] {
 	min-width: 0;
 }
-.cn-dashboard-page__title-row[data-v-20ca81f3] {
+.cn-dashboard-page__title-row[data-v-42bc14a4] {
 	display: flex;
 	align-items: center;
 	flex-wrap: wrap;
 	gap: 12px;
 }
-.cn-dashboard-page__title[data-v-20ca81f3] {
+.cn-dashboard-page__title[data-v-42bc14a4] {
 	margin: 0;
 	font-size: 20px;
 	font-weight: 700;
 }
-.cn-dashboard-page__description[data-v-20ca81f3] {
+.cn-dashboard-page__description[data-v-42bc14a4] {
 	margin: 4px 0 0;
 	font-size: 14px;
 	color: var(--color-text-maxcontrast);
@@ -38506,19 +38506,19 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 
 /* Board look (screens-dashboard-parity): h1 28/700, a 15px grey subtitle 6px
    under it, and 40px buttons with a 10px gap. */
-.cn-dashboard-page--board .cn-dashboard-page__title[data-v-20ca81f3] {
+.cn-dashboard-page--board .cn-dashboard-page__title[data-v-42bc14a4] {
 	font-size: 28px;
 	font-weight: 700;
 	line-height: 1.2;
 }
-.cn-dashboard-page--board .cn-dashboard-page__description[data-v-20ca81f3] {
+.cn-dashboard-page--board .cn-dashboard-page__description[data-v-42bc14a4] {
 	margin: 6px 0 0;
 	font-size: 15px;
 }
-.cn-dashboard-page--board .cn-dashboard-page__header-actions[data-v-20ca81f3] {
+.cn-dashboard-page--board .cn-dashboard-page__header-actions[data-v-42bc14a4] {
 	gap: 10px;
 }
-.cn-dashboard-page--board .cn-dashboard-page__header-actions[data-v-20ca81f3] .button-vue {
+.cn-dashboard-page--board .cn-dashboard-page__header-actions[data-v-42bc14a4] .button-vue {
 	min-height: var(--cn-board-control-height, 40px);
 	height: var(--cn-board-control-height, 40px);
 }
@@ -38526,17 +38526,17 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 /* The switch row under the header (screens-dashboard-greeting-header): the
    view switch left, the `viewLinks` pills right (DqMijnWerk: pills 34px high,
    radius 17, 13px/600, a 14px icon, primary light on primary deep). */
-.cn-dashboard-page__switch-row[data-v-20ca81f3] {
+.cn-dashboard-page__switch-row[data-v-42bc14a4] {
 	display: flex;
 	flex-wrap: wrap;
 	align-items: center;
 	gap: 10px;
 	margin-bottom: var(--cn-board-section-gap, 20px);
 }
-.cn-dashboard-page__switch-row-spacer[data-v-20ca81f3] {
+.cn-dashboard-page__switch-row-spacer[data-v-42bc14a4] {
 	flex: 1 1 auto;
 }
-.cn-dashboard-page__view-link[data-v-20ca81f3] {
+.cn-dashboard-page__view-link[data-v-42bc14a4] {
 	display: inline-flex;
 	align-items: center;
 	gap: 6px;
@@ -38550,36 +38550,36 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 	white-space: nowrap;
 	text-decoration: none !important;
 }
-.cn-dashboard-page__view-link[data-v-20ca81f3]:hover {
+.cn-dashboard-page__view-link[data-v-42bc14a4]:hover {
 	background: var(--color-primary-element-light-hover, var(--color-primary-element-light));
 }
-.cn-dashboard-page__view-link[data-v-20ca81f3]:focus-visible {
+.cn-dashboard-page__view-link[data-v-42bc14a4]:focus-visible {
 	outline: 2px solid var(--color-main-text);
 	outline-offset: 2px;
 }
-.cn-dashboard-page__view-link-icon[data-v-20ca81f3] {
+.cn-dashboard-page__view-link-icon[data-v-42bc14a4] {
 	display: inline-flex;
 }
 
 /* The period group, in a row of its own between the header and the KPI row. */
-.cn-dashboard-page__date-range--segmented[data-v-20ca81f3] {
+.cn-dashboard-page__date-range--segmented[data-v-42bc14a4] {
 	margin-bottom: 16px;
 }
-.cn-dashboard-page__date-segmented[data-v-20ca81f3] {
+.cn-dashboard-page__date-segmented[data-v-42bc14a4] {
 	display: flex;
 	align-items: center;
 	gap: 8px;
 }
 
 /* The KPI row above the grid: tiles are cells of the auto-fit grid. */
-.cn-dashboard-page__kpi-row[data-v-20ca81f3] {
+.cn-dashboard-page__kpi-row[data-v-42bc14a4] {
 	margin-bottom: var(--cn-board-section-gap, 16px);
 }
-.cn-dashboard-page__kpi-cell[data-v-20ca81f3] {
+.cn-dashboard-page__kpi-cell[data-v-42bc14a4] {
 	display: flex;
 	min-width: 0;
 }
-.cn-dashboard-page__kpi-cell[data-v-20ca81f3] > * {
+.cn-dashboard-page__kpi-cell[data-v-42bc14a4] > * {
 	flex: 1 1 auto;
 	min-width: 0;
 }
@@ -38592,7 +38592,7 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
    scoped chip rules then silently don't match and the chip collapses into
    NcActions' ~30px icon slot (text wraps to "Last / 30 / days"). The
    data-testid is stable across chunks, so those rules match regardless. */
-.cn-dashboard-page__header-actions[data-v-20ca81f3] {
+.cn-dashboard-page__header-actions[data-v-42bc14a4] {
 	display: flex;
 	align-items: center;
 	gap: 8px;
@@ -38608,19 +38608,19 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 
 /* Date-range header band. Kept compact so it doesn't open a tall gap
    above the grid; the pills variant is a single tidy toggle row. */
-.cn-dashboard-page__date-range[data-v-20ca81f3] {
+.cn-dashboard-page__date-range[data-v-42bc14a4] {
 	margin-bottom: 12px;
 }
-.cn-dashboard-page__date-range--pills[data-v-20ca81f3] {
+.cn-dashboard-page__date-range--pills[data-v-42bc14a4] {
 	margin-bottom: 8px;
 }
-.cn-dashboard-page__date-pills[data-v-20ca81f3] {
+.cn-dashboard-page__date-pills[data-v-42bc14a4] {
 	display: flex;
 	align-items: center;
 	flex-wrap: wrap;
 	gap: 6px;
 }
-.cn-dashboard-page__date-pill[data-v-20ca81f3] {
+.cn-dashboard-page__date-pill[data-v-42bc14a4] {
 	display: inline-flex;
 	align-items: center;
 	padding: 5px 14px;
@@ -38635,77 +38635,77 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 	cursor: pointer;
 	transition: background-color 100ms ease, border-color 100ms ease, color 100ms ease;
 }
-.cn-dashboard-page__date-pill[data-v-20ca81f3]:hover {
+.cn-dashboard-page__date-pill[data-v-42bc14a4]:hover {
 	background: var(--color-background-hover);
 }
-.cn-dashboard-page__date-pill[data-v-20ca81f3]:focus-visible {
+.cn-dashboard-page__date-pill[data-v-42bc14a4]:focus-visible {
 	outline: 2px solid var(--color-primary-element);
 	outline-offset: 2px;
 }
-.cn-dashboard-page__date-pill--active[data-v-20ca81f3] {
+.cn-dashboard-page__date-pill--active[data-v-42bc14a4] {
 	background: var(--color-primary-element);
 	border-color: var(--color-primary-element);
 	color: var(--color-primary-element-text);
 }
-.cn-dashboard-page__date-pill--active[data-v-20ca81f3]:hover {
+.cn-dashboard-page__date-pill--active[data-v-42bc14a4]:hover {
 	background: var(--color-primary-element-hover, var(--color-primary-element));
 }
 
 /* The custom-range pill is de-emphasised — dashed outline, muted text —
    so it reads as an escape hatch rather than a primary option. */
-.cn-dashboard-page__date-pill--custom[data-v-20ca81f3] {
+.cn-dashboard-page__date-pill--custom[data-v-42bc14a4] {
 	border-style: dashed;
 	color: var(--color-text-maxcontrast);
 }
-.cn-dashboard-page__date-pill-custom[data-v-20ca81f3] .action-item__menutoggle {
+.cn-dashboard-page__date-pill-custom[data-v-42bc14a4] .action-item__menutoggle {
 	min-width: 0;
 	min-height: 0;
 	padding: 0;
 	background: transparent;
 	border: none;
 }
-.cn-dashboard-page__date-pill-custom[data-v-20ca81f3] .button-vue,
-.cn-dashboard-page__date-pill-custom[data-v-20ca81f3] .button-vue__wrapper,
-.cn-dashboard-page__date-pill-custom[data-v-20ca81f3] .button-vue__icon {
+.cn-dashboard-page__date-pill-custom[data-v-42bc14a4] .button-vue,
+.cn-dashboard-page__date-pill-custom[data-v-42bc14a4] .button-vue__wrapper,
+.cn-dashboard-page__date-pill-custom[data-v-42bc14a4] .button-vue__icon {
 	width: auto !important;
 	min-width: 0 !important;
 	overflow: visible !important;
 }
-.cn-dashboard-page__empty[data-v-20ca81f3] {
+.cn-dashboard-page__empty[data-v-42bc14a4] {
 	padding: 60px 20px;
 }
 
 /* The page's view switch on a page without a header row: at the end of its
    own row, above the grids, where the header would have put it. */
-.cn-dashboard-page__view-switch[data-v-20ca81f3] {
+.cn-dashboard-page__view-switch[data-v-42bc14a4] {
 	display: flex;
 	justify-content: flex-end;
 	margin-bottom: 12px;
 }
 
 /* A view the switch shows with nothing to draw. */
-.cn-page-view-region--empty[data-v-20ca81f3] {
+.cn-page-view-region--empty[data-v-42bc14a4] {
 	padding: 40px 20px;
 }
-.cn-dashboard-page__page-filters[data-v-20ca81f3] {
+.cn-dashboard-page__page-filters[data-v-42bc14a4] {
 	display: flex;
 	flex-wrap: wrap;
 	gap: 16px;
 	align-items: flex-end;
 	margin-bottom: 12px;
 }
-.cn-dashboard-page__page-filter[data-v-20ca81f3] {
+.cn-dashboard-page__page-filter[data-v-42bc14a4] {
 	display: flex;
 	flex-direction: column;
 	gap: 4px;
 	min-width: 200px;
 }
-.cn-dashboard-page__page-filter-label[data-v-20ca81f3] {
+.cn-dashboard-page__page-filter-label[data-v-42bc14a4] {
 	font-size: 0.85em;
 	font-weight: 600;
 	color: var(--color-text-maxcontrast);
 }
-.cn-dashboard-page__widget-edit[data-v-20ca81f3] {
+.cn-dashboard-page__widget-edit[data-v-42bc14a4] {
 	position: absolute;
 	top: 4px;
 	inset-inline-end: 4px;
@@ -38724,8 +38724,8 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
    and centre the card. */
 /* `safe` centre so an overflowing tile does not spill out of the top, where
    flex overflow cannot be scrolled back to. Same as detail-page.css. */
-.cn-dashboard-page__card-fit[data-v-20ca81f3] .cn-widget-wrapper__content,
-.cn-dashboard-page__card-fit.cn-widget-wrapper--flush[data-v-20ca81f3] .cn-widget-wrapper__content {
+.cn-dashboard-page__card-fit[data-v-42bc14a4] .cn-widget-wrapper__content,
+.cn-dashboard-page__card-fit.cn-widget-wrapper--flush[data-v-42bc14a4] .cn-widget-wrapper__content {
 	overflow: hidden;
 	display: flex;
 	flex-direction: column;
@@ -38741,7 +38741,7 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
    shows up as a scrollbar the user has to drag to see the whole graph. Same
    shape as the card-fit rule above, minus the padding: chart tiles render
    `flush`, and apexcharts already draws its own margins. */
-.cn-dashboard-page__chart-fit[data-v-20ca81f3] .cn-widget-wrapper__content {
+.cn-dashboard-page__chart-fit[data-v-42bc14a4] .cn-widget-wrapper__content {
 	overflow: hidden;
 	display: flex;
 	flex-direction: column;
@@ -38751,13 +38751,13 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 /* Card content (stat / gauge / delta) must fit the tile width: let the
    widget shrink and its value/label truncate instead of pushing past the
    tile edge (the horizontal clip on long currency values). */
-.cn-dashboard-page__card-fit[data-v-20ca81f3] .cn-stat-widget,
-.cn-dashboard-page__card-fit[data-v-20ca81f3] .cn-gauge-widget,
-.cn-dashboard-page__card-fit[data-v-20ca81f3] .cn-delta-widget {
+.cn-dashboard-page__card-fit[data-v-42bc14a4] .cn-stat-widget,
+.cn-dashboard-page__card-fit[data-v-42bc14a4] .cn-gauge-widget,
+.cn-dashboard-page__card-fit[data-v-42bc14a4] .cn-delta-widget {
 	min-width: 0;
 	max-width: 100%;
 }
-.cn-dashboard-page__unknown[data-v-20ca81f3] {
+.cn-dashboard-page__unknown[data-v-42bc14a4] {
 	display: flex;
 	align-items: center;
 	justify-content: center;
@@ -38768,29 +38768,29 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 }
 
 /* widget-ref content items */
-.cn-dashboard-page__content[data-v-20ca81f3] {
+.cn-dashboard-page__content[data-v-42bc14a4] {
 	display: flex;
 	flex-direction: column;
 	gap: 16px;
 }
-.cn-dashboard-page__content-item[data-v-20ca81f3] {
+.cn-dashboard-page__content-item[data-v-42bc14a4] {
 	width: 100%;
 }
 /* On a phone (screens-dashboard-phone) the touch targets of a board dashboard
    are 44px: the widget Actions menu and the KPI tiles. */
 @media (max-width: 640px) {
-.cn-dashboard-page--board[data-v-20ca81f3] .cn-widget-wrapper__actions .action-item__menutoggle,
-	.cn-dashboard-page--board[data-v-20ca81f3] .cn-widget-wrapper__actions .button-vue {
+.cn-dashboard-page--board[data-v-42bc14a4] .cn-widget-wrapper__actions .action-item__menutoggle,
+	.cn-dashboard-page--board[data-v-42bc14a4] .cn-widget-wrapper__actions .button-vue {
 		min-height: 44px;
 }
-.cn-dashboard-page--board .cn-dashboard-page__kpi-cell[data-v-20ca81f3] {
+.cn-dashboard-page--board .cn-dashboard-page__kpi-cell[data-v-42bc14a4] {
 		min-height: 44px;
 }
 }
 
 /* What a registry widget reports for its card header (`header` event): the
    note beside the link ("3 in total") and one action, as on a detail page. */
-.cn-dashboard-page__widget-count[data-v-20ca81f3] {
+.cn-dashboard-page__widget-count[data-v-42bc14a4] {
 	align-self: center;
 	padding: 1px 8px;
 	border-radius: 10px;
@@ -38799,13 +38799,13 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 	font-size: 13px;
 	font-weight: 600;
 }
-.cn-dashboard-page__widget-note[data-v-20ca81f3] {
+.cn-dashboard-page__widget-note[data-v-42bc14a4] {
 	align-self: center;
 	color: var(--color-text-maxcontrast);
 	font-size: 14px;
 	white-space: nowrap;
 }
-.cn-dashboard-page__widget-action[data-v-20ca81f3] {
+.cn-dashboard-page__widget-action[data-v-42bc14a4] {
 	display: inline-flex;
 	align-items: center;
 	align-self: center;
@@ -38821,7 +38821,7 @@ button.cn-object-calendar__overflow[data-v-e1c69ee2] {
 	white-space: nowrap;
 	cursor: pointer;
 }
-.cn-dashboard-page__widget-action[data-v-20ca81f3]:focus-visible {
+.cn-dashboard-page__widget-action[data-v-42bc14a4]:focus-visible {
 	outline: 2px solid var(--color-primary-element);
 	outline-offset: 2px;
 }

package/dist/esm/utils/declaredProps.js

@@ -0,0 +1,106 @@
+import { camelize } from 'vue';
+
+/**
+ * SPDX-FileCopyrightText: 2026 Conduction B.V.
+ * SPDX-License-Identifier: EUPL-1.2
+ */
+
+
+const warned = new Set();
+
+/**
+ * Add the prop names one component options object declares, following its
+ * `extends` and `mixins`.
+ *
+ * @param {object} options A component options object.
+ * @param {Set<string>} names The set to add camelCase prop names to.
+ * @param {number} depth Recursion guard.
+ */
+function collect(options, names, depth) {
+	if (!options || typeof options !== 'object' || depth > 8) {
+		return
+	}
+	const props = options.props;
+	if (Array.isArray(props)) {
+		props.forEach((name) => names.add(camelize(String(name))));
+	} else if (props && typeof props === 'object') {
+		Object.keys(props).forEach((name) => names.add(camelize(name)));
+	}
+	collect(options.extends, names, depth + 1);
+	if (Array.isArray(options.mixins)) {
+		options.mixins.forEach((mixin) => collect(mixin, names, depth + 1));
+	}
+}
+
+/**
+ * The prop names a component declares, or `null` when it takes every
+ * attribute itself and so must keep receiving all of them:
+ *  - `inheritAttrs: false`: the component forwards `$attrs` on purpose;
+ *  - a functional component without `props`: its attrs are its props;
+ *  - an async component that has not resolved yet.
+ *
+ * @spec openspec/changes/dashboard-declared-widget-props/specs/dashboard-page/spec.md#requirement-a-dashboard-widget-receives-only-the-content-keys-it-declares
+ * @param {object|((...args: unknown[]) => unknown)|null} component A component definition.
+ * @return {Set<string>|null} camelCase prop names, or null for "all".
+ */
+function declaredPropNames(component) {
+	if (!component) {
+		return null
+	}
+	if (typeof component === 'function') {
+		if (!component.props) {
+			return null
+		}
+		const names = new Set();
+		collect({ props: component.props }, names, 0);
+		return names
+	}
+	if (typeof component !== 'object') {
+		return null
+	}
+	if (component.__asyncLoader) {
+		return component.__asyncResolved ? declaredPropNames(component.__asyncResolved) : null
+	}
+	const chain = [component, component.extends, ...(component.mixins || [])];
+	if (chain.some((options) => options && options.inheritAttrs === false)) {
+		return null
+	}
+	const names = new Set();
+	collect(component, names, 0);
+	return names
+}
+
+/**
+ * Keep the entries of `bindings` whose key `component` declares as a prop.
+ * A component for which {@link declaredPropNames} returns null gets every
+ * entry. A dropped key is warned about once outside production when the
+ * component has no `content` prop either, so the key reaches nothing.
+ *
+ * @spec openspec/changes/dashboard-declared-widget-props/specs/dashboard-page/spec.md#requirement-a-dashboard-widget-receives-only-the-content-keys-it-declares
+ * @param {object|((...args: unknown[]) => unknown)|null} component The component that will receive the bindings.
+ * @param {object} bindings The candidate bindings.
+ * @param {string} label Names the component in the warning (for example the widget type).
+ * @return {object} The bindings the component declares.
+ */
+function pickDeclaredProps(component, bindings, label) {
+	const declared = declaredPropNames(component);
+	if (!declared || !bindings || typeof bindings !== 'object') {
+		return bindings
+	}
+	const out = {};
+	for (const [key, value] of Object.entries(bindings)) {
+		if (declared.has(camelize(key))) {
+			out[key] = value;
+			continue
+		}
+		if (process.env.NODE_ENV !== 'production' && !declared.has('content') && !warned.has(`${label}\u0000${key}`)) {
+			warned.add(`${label}\u0000${key}`);
+			// eslint-disable-next-line no-console
+			console.warn(`[nextcloud-vue] content key "${key}" is not passed to widget "${label}": it declares neither that prop nor \`content\`.`);
+		}
+	}
+	return out
+}
+
+export { declaredPropNames, pickDeclaredProps };
+//# sourceMappingURL=declaredProps.js.map

package/dist/esm/utils/declaredProps.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaredProps.js","sources":["../../../src/utils/declaredProps.js"],"sourcesContent":["/**\n * SPDX-FileCopyrightText: 2026 Conduction B.V.\n * SPDX-License-Identifier: EUPL-1.2\n */\n\n/*\n * `process.env.NODE_ENV` is substituted by every consuming app's bundler at\n * build time; see NcSelectTags.js.\n */\n/* global process */\n\nimport { camelize } from 'vue'\n\nconst warned = new Set()\n\n/**\n * Add the prop names one component options object declares, following its\n * `extends` and `mixins`.\n *\n * @param {object} options A component options object.\n * @param {Set<string>} names The set to add camelCase prop names to.\n * @param {number} depth Recursion guard.\n */\nfunction collect(options, names, depth) {\n\tif (!options || typeof options !== 'object' || depth > 8) {\n\t\treturn\n\t}\n\tconst props = options.props\n\tif (Array.isArray(props)) {\n\t\tprops.forEach((name) => names.add(camelize(String(name))))\n\t} else if (props && typeof props === 'object') {\n\t\tObject.keys(props).forEach((name) => names.add(camelize(name)))\n\t}\n\tcollect(options.extends, names, depth + 1)\n\tif (Array.isArray(options.mixins)) {\n\t\toptions.mixins.forEach((mixin) => collect(mixin, names, depth + 1))\n\t}\n}\n\n/**\n * The prop names a component declares, or `null` when it takes every\n * attribute itself and so must keep receiving all of them:\n *  - `inheritAttrs: false`: the component forwards `$attrs` on purpose;\n *  - a functional component without `props`: its attrs are its props;\n *  - an async component that has not resolved yet.\n *\n * @spec openspec/changes/dashboard-declared-widget-props/specs/dashboard-page/spec.md#requirement-a-dashboard-widget-receives-only-the-content-keys-it-declares\n * @param {object|((...args: unknown[]) => unknown)|null} component A component definition.\n * @return {Set<string>|null} camelCase prop names, or null for \"all\".\n */\nexport function declaredPropNames(component) {\n\tif (!component) {\n\t\treturn null\n\t}\n\tif (typeof component === 'function') {\n\t\tif (!component.props) {\n\t\t\treturn null\n\t\t}\n\t\tconst names = new Set()\n\t\tcollect({ props: component.props }, names, 0)\n\t\treturn names\n\t}\n\tif (typeof component !== 'object') {\n\t\treturn null\n\t}\n\tif (component.__asyncLoader) {\n\t\treturn component.__asyncResolved ? declaredPropNames(component.__asyncResolved) : null\n\t}\n\tconst chain = [component, component.extends, ...(component.mixins || [])]\n\tif (chain.some((options) => options && options.inheritAttrs === false)) {\n\t\treturn null\n\t}\n\tconst names = new Set()\n\tcollect(component, names, 0)\n\treturn names\n}\n\n/**\n * Keep the entries of `bindings` whose key `component` declares as a prop.\n * A component for which {@link declaredPropNames} returns null gets every\n * entry. A dropped key is warned about once outside production when the\n * component has no `content` prop either, so the key reaches nothing.\n *\n * @spec openspec/changes/dashboard-declared-widget-props/specs/dashboard-page/spec.md#requirement-a-dashboard-widget-receives-only-the-content-keys-it-declares\n * @param {object|((...args: unknown[]) => unknown)|null} component The component that will receive the bindings.\n * @param {object} bindings The candidate bindings.\n * @param {string} label Names the component in the warning (for example the widget type).\n * @return {object} The bindings the component declares.\n */\nexport function pickDeclaredProps(component, bindings, label) {\n\tconst declared = declaredPropNames(component)\n\tif (!declared || !bindings || typeof bindings !== 'object') {\n\t\treturn bindings\n\t}\n\tconst out = {}\n\tfor (const [key, value] of Object.entries(bindings)) {\n\t\tif (declared.has(camelize(key))) {\n\t\t\tout[key] = value\n\t\t\tcontinue\n\t\t}\n\t\tif (process.env.NODE_ENV !== 'production' && !declared.has('content') && !warned.has(`${label}\\u0000${key}`)) {\n\t\t\twarned.add(`${label}\\u0000${key}`)\n\t\t\t// eslint-disable-next-line no-console\n\t\t\tconsole.warn(`[nextcloud-vue] content key \"${key}\" is not passed to widget \"${label}\": it declares neither that prop nor \\`content\\`.`)\n\t\t}\n\t}\n\treturn out\n}\n\n/**\n * Forget which keys were warned about. For tests.\n */\nexport function resetDeclaredPropWarnings() {\n\twarned.clear()\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/utils/gridStack.js

@@ -65,8 +65,11 @@ function readGridGeometry(items) {
  * full-width card under the stat tiles landed below the lists.
  *
  * @spec openspec/changes/dashboard-growth-keeps-order/specs/dashboard-grid/spec.md#requirement-a-growing-cell-keeps-the-order-of-the-cards-under-it
- * @param {Array<{x: number, y: number, w: number, h: number}>} nodes The grid's items (the growing one among them).
- * @param {{x: number, y: number, w: number, h: number}} node The growing item.
+ * The growing item is never among the items it moves, also when `nodes`
+ * holds another reference to it (a proxy of the same node, matched by `el`).
+ *
+ * @param {Array<{x: number, y: number, w: number, h: number, el: (HTMLElement|undefined)}>} nodes The grid's items (the growing one among them).
+ * @param {{x: number, y: number, w: number, h: number, el: (HTMLElement|undefined)}} node The growing item.
  * @param {number} h Its new height, in grid rows.
  * @return {Array<{node: object, y: number}>} The items to move and their new row, bottom-most first.
  */
@@ -81,7 +84,8 @@ function planGrowth(nodes, node, h) {
 	while (queue.length > 0) {
 		const rect = queue.shift();
 		for (const other of nodes) {
-			if (other === node || moved.has(other) || !overlaps(rect, other)) {
+			const self = other === node || (node.el && other.el === node.el);
+			if (self || moved.has(other) || !overlaps(rect, other)) {
 				continue
 			}
 			const next = { x: other.x, y: other.y + delta, w: other.w, h: other.h };

package/dist/esm/utils/gridStack.js.map

@@ -1 +1 @@
-{"version":3,"file":"gridStack.js","sources":["../../../src/utils/gridStack.js"],"sourcesContent":["/**\n * Thin GridStack bootstrap shared by the drag/resize grids (CnDashboardGrid and\n * CnWidgetGrid's editable body slot). Keeps the GridStack option shape in one\n * place so the two engines stay consistent.\n *\n * @module utils/gridStack\n */\n\nimport { GridStack } from 'gridstack'\n// `gridstack` is a peerDependency, not bundled — see the matching comment in\n// CnDashboardGrid.vue. The consumer must install `gridstack` themselves and\n// import its stylesheet (`gridstack/dist/gridstack.min.css`) from that same\n// copy; nc-vue ships no GridStack CSS of its own so the JS driving the grid\n// and the CSS sizing it can never come from two different versions.\n\n/**\n * Initialise a GridStack instance on a `.grid-stack` element.\n *\n * @param {HTMLElement} el The `.grid-stack` container element.\n * @param {object} opts Options.\n * @param {number} opts.columns Column count.\n * @param {boolean} opts.editable Whether drag + resize are enabled.\n * @param {number} [opts.cellHeight] Cell height in px (default 80).\n * @param {number} [opts.margin] Grid margin in px (default 12).\n * @return {import('gridstack').GridStack} The GridStack instance.\n */\nexport function initGridStack(el, opts) {\n\tconst { columns, editable, cellHeight = 80, margin = 12 } = opts\n\treturn GridStack.init({\n\t\tcolumn: columns,\n\t\tcellHeight,\n\t\tmargin,\n\t\tfloat: true,\n\t\tanimate: true,\n\t\tdisableDrag: !editable,\n\t\tdisableResize: !editable,\n\t\tremovable: false,\n\t}, el)\n}\n\n/**\n * Read the geometry GridStack reports for a changed set of items into a plain\n * map keyed by node id.\n *\n * @param {Array<{id: (string|number), x: number, y: number, w: number, h: number}>} items\n *   The items GridStack passes to its `change` handler.\n * @return {Map<string, {gridX: number, gridY: number, gridWidth: number, gridHeight: number}>}\n */\nexport function readGridGeometry(items) {\n\tconst map = new Map()\n\tfor (const it of items || []) {\n\t\tmap.set(String(it.id), { gridX: it.x, gridY: it.y, gridWidth: it.w, gridHeight: it.h })\n\t}\n\treturn map\n}\n\n/**\n * Where the items under a growing cell go so they keep their order: every item\n * the growth would overlap moves down by the growth, and so does every item\n * that move would overlap in turn. Items beside the cell stay put.\n *\n * GridStack resolves the same collision itself, but not in order: when\n * pipelinq's size-to-content banner grew from two rows to three, the\n * full-width card under the stat tiles landed below the lists.\n *\n * @spec openspec/changes/dashboard-growth-keeps-order/specs/dashboard-grid/spec.md#requirement-a-growing-cell-keeps-the-order-of-the-cards-under-it\n * @param {Array<{x: number, y: number, w: number, h: number}>} nodes The grid's items (the growing one among them).\n * @param {{x: number, y: number, w: number, h: number}} node The growing item.\n * @param {number} h Its new height, in grid rows.\n * @return {Array<{node: object, y: number}>} The items to move and their new row, bottom-most first.\n */\nexport function planGrowth(nodes, node, h) {\n\tconst delta = h - node.h\n\tif (!(delta > 0)) {\n\t\treturn []\n\t}\n\tconst moved = new Map()\n\tconst overlaps = (a, b) => a.x < b.x + b.w && b.x < a.x + a.w && a.y < b.y + b.h && b.y < a.y + a.h\n\tconst queue = [{ x: node.x, y: node.y, w: node.w, h }]\n\twhile (queue.length > 0) {\n\t\tconst rect = queue.shift()\n\t\tfor (const other of nodes) {\n\t\t\tif (other === node || moved.has(other) || !overlaps(rect, other)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst next = { x: other.x, y: other.y + delta, w: other.w, h: other.h }\n\t\t\tmoved.set(other, next.y)\n\t\t\tqueue.push(next)\n\t\t}\n\t}\n\treturn [...moved.entries()]\n\t\t.map(([item, y]) => ({ node: item, y }))\n\t\t.sort((a, b) => b.y - a.y)\n}\n"],"names":[],"mappings":"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"}
+{"version":3,"file":"gridStack.js","sources":["../../../src/utils/gridStack.js"],"sourcesContent":["/**\n * Thin GridStack bootstrap shared by the drag/resize grids (CnDashboardGrid and\n * CnWidgetGrid's editable body slot). Keeps the GridStack option shape in one\n * place so the two engines stay consistent.\n *\n * @module utils/gridStack\n */\n\nimport { GridStack } from 'gridstack'\n// `gridstack` is a peerDependency, not bundled — see the matching comment in\n// CnDashboardGrid.vue. The consumer must install `gridstack` themselves and\n// import its stylesheet (`gridstack/dist/gridstack.min.css`) from that same\n// copy; nc-vue ships no GridStack CSS of its own so the JS driving the grid\n// and the CSS sizing it can never come from two different versions.\n\n/**\n * Initialise a GridStack instance on a `.grid-stack` element.\n *\n * @param {HTMLElement} el The `.grid-stack` container element.\n * @param {object} opts Options.\n * @param {number} opts.columns Column count.\n * @param {boolean} opts.editable Whether drag + resize are enabled.\n * @param {number} [opts.cellHeight] Cell height in px (default 80).\n * @param {number} [opts.margin] Grid margin in px (default 12).\n * @return {import('gridstack').GridStack} The GridStack instance.\n */\nexport function initGridStack(el, opts) {\n\tconst { columns, editable, cellHeight = 80, margin = 12 } = opts\n\treturn GridStack.init({\n\t\tcolumn: columns,\n\t\tcellHeight,\n\t\tmargin,\n\t\tfloat: true,\n\t\tanimate: true,\n\t\tdisableDrag: !editable,\n\t\tdisableResize: !editable,\n\t\tremovable: false,\n\t}, el)\n}\n\n/**\n * Read the geometry GridStack reports for a changed set of items into a plain\n * map keyed by node id.\n *\n * @param {Array<{id: (string|number), x: number, y: number, w: number, h: number}>} items\n *   The items GridStack passes to its `change` handler.\n * @return {Map<string, {gridX: number, gridY: number, gridWidth: number, gridHeight: number}>}\n */\nexport function readGridGeometry(items) {\n\tconst map = new Map()\n\tfor (const it of items || []) {\n\t\tmap.set(String(it.id), { gridX: it.x, gridY: it.y, gridWidth: it.w, gridHeight: it.h })\n\t}\n\treturn map\n}\n\n/**\n * Where the items under a growing cell go so they keep their order: every item\n * the growth would overlap moves down by the growth, and so does every item\n * that move would overlap in turn. Items beside the cell stay put.\n *\n * GridStack resolves the same collision itself, but not in order: when\n * pipelinq's size-to-content banner grew from two rows to three, the\n * full-width card under the stat tiles landed below the lists.\n *\n * @spec openspec/changes/dashboard-growth-keeps-order/specs/dashboard-grid/spec.md#requirement-a-growing-cell-keeps-the-order-of-the-cards-under-it\n * The growing item is never among the items it moves, also when `nodes`\n * holds another reference to it (a proxy of the same node, matched by `el`).\n *\n * @param {Array<{x: number, y: number, w: number, h: number, el: (HTMLElement|undefined)}>} nodes The grid's items (the growing one among them).\n * @param {{x: number, y: number, w: number, h: number, el: (HTMLElement|undefined)}} node The growing item.\n * @param {number} h Its new height, in grid rows.\n * @return {Array<{node: object, y: number}>} The items to move and their new row, bottom-most first.\n */\nexport function planGrowth(nodes, node, h) {\n\tconst delta = h - node.h\n\tif (!(delta > 0)) {\n\t\treturn []\n\t}\n\tconst moved = new Map()\n\tconst overlaps = (a, b) => a.x < b.x + b.w && b.x < a.x + a.w && a.y < b.y + b.h && b.y < a.y + a.h\n\tconst queue = [{ x: node.x, y: node.y, w: node.w, h }]\n\twhile (queue.length > 0) {\n\t\tconst rect = queue.shift()\n\t\tfor (const other of nodes) {\n\t\t\tconst self = other === node || (node.el && other.el === node.el)\n\t\t\tif (self || moved.has(other) || !overlaps(rect, other)) {\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\tconst next = { x: other.x, y: other.y + delta, w: other.w, h: other.h }\n\t\t\tmoved.set(other, next.y)\n\t\t\tqueue.push(next)\n\t\t}\n\t}\n\treturn [...moved.entries()]\n\t\t.map(([item, y]) => ({ node: item, y }))\n\t\t.sort((a, b) => b.y - a.y)\n}\n"],"names":[],"mappings":"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"}