[RFC] nextcloud/vue eslint plugin rules

[Antreesy]

Based on #939

To be discussed:

• what's worth efforts to be highlighted with eslint
  • ref: deprecations at 9.0.0
• what's worth efforts to be handled with eslint --fix
  • ref: deprecations at 9.0.0 with backward compatibility at 8.x.x
• for each rule find the first release in nextcloud/vue@8.x.x we started to deprecate something for the next branch that's worth linting
  • e.g. deprecated imports -> 8.23.0

References for Vue template traversing:

• https://eslint.vuejs.org/developer-guide/
• https://astexplorer.net/

[ShGKme]

The import was a simple case that RE can handle. In most of the other cases we'd need to develop codemods.
IMO, it isn't worth it on our codebase size.

[susnux]

The import was a simple case that RE can handle. In most of the other cases we'd need to develop codemods.

I think a very common thing that can be handled:

• NcButton:
  • nativeType -> type
  • type -> variant

This is a pain to migrate otherwise 😅

[Antreesy]

@nextcloud/vue deprecation coverage report

Ran by Opus 4.8

Scope: all components/modules carrying @deprecated markers on stable8 (v8, 8.39.0) and main (v9, 9.8.2), cross-checked with t
he v9 CHANGELOG "💥 Breaking Changes" section.
Compared against: lib/plugins/nextcloud/rules/no-deprecated-library-props.ts and no-deprecated-library-exports.ts.

Legend — v9 status: removed = gone in v9 · deprecated = still present & deprecated in v9 · repurposed = kept with new meaning.
Covered: ✅ has a rule · ❌ no rule · ⚠️ partially covered.

---

1. Props

Component	Prop (template form)	Kind	→ Replacement	Deprecated since	v9 status	Covered
NcActions	type	prop	variant	8.24.0	removed	✅
NcAppNavigationNew	type	prop	variant	8.24.0	removed	✅
NcButton	type (color values)	prop	variant	8.24.0	repurposed (native types only)	✅
NcChip	type	prop	variant	8.24.0	removed/renamed	✅
NcDialogButton	type (color values)	prop	variant	8.24.0	removed	✅
NcButton	native-type	prop	type	8.24.0	removed	✅
NcDialogButton	native-type	prop	type	8.24.0	removed	✅
NcActionButton / Input / Link / Actions	aria-hidden	prop	remove	8.2.0	removed	✅
NcButton	aria-hidden	prop	remove	8.2.0	removed	✅
NcAppContent	allow-swipe-navigation	prop	disable-swipe	8.23.0	removed	✅
NcAvatar	show-user-status	prop	hide-status	8.24.0	removed	✅
NcAvatar	show-user-status-compact	prop	verbose-status	8.24.0	removed	✅
NcAvatar	allow-placeholder	prop	no-placeholder	8.24.0	removed	✅
NcDateTimePicker	formatter	prop	format	8.25.0	removed	✅
NcDateTimePicker	range	prop	type="date-range"/datetime-range	8.25.0	removed	✅
NcDateTimePicker	lang	prop	locale	9.0.0	deprecated	✅
NcDialog	can-close	prop	no-close	8.24.0	removed	✅
NcModal	can-close	prop	no-close	8.24.0	removed	✅
NcModal	enable-swipe	prop	disable-swipe	8.23.0	removed	✅
NcModal	close-button-contained	prop	close-button-outside	8.32.0	removed	✅
NcPopover	focus-trap	prop	no-focus-trap	8.26.0	removed	✅
NcPopover	close-on-click-outside	prop	no-close-on-click-outside	9.0.0	deprecated	✅
NcSelect	close-on-select	prop	keep-open	8.25.0	removed	✅
NcSelect	user-select	prop	NcSelectUsers component	8.27.1	removed	✅
NcTextField	trailing-button-icon="arrowRight"	prop value	"arrowEnd"	8.28.0	removed	✅
NcSettingsSection	limit-width	prop	remove	8.13.0	removed	✅
NcActionRouter / NcAppNavigationItem / NcBreadcrumb / NcButton / NcListItem	exact	prop	remove	9.0.0	removed	✅
NcActionCheckbox / NcActionRadio / NcCheckboxRadioSwitch	checked	prop	model-value / v-model	8.20.0	removed	✅
NcActionInput / NcActionTextEditable / NcColorPicker / NcDateTimePicker / NcDateTimePickerNative / NcInputField / NcPasswordField / NcRichContenteditable / NcSelect / NcSelectTags / NcSettingsInputText / NcSettingsSelectGroup / NcTextArea / NcTextField / NcTimezonePicker	value	prop	model-value / v-model	8.20.0	removed	✅
NcCheckboxRadioSwitch	button-variant	prop	use NcRadioGroup	v8	deprecated	❌
NcCheckboxRadioSwitch	button-variant-grouped	prop	use NcRadioGroup	v8	deprecated	❌
NcRadioGroup	label-hidden	prop	hide-label	v8	deprecated	❌
NcAppSettingsDialog	legacy	prop	remove (design going away)	v8	deprecated	❌
NcAutoCompleteResult	title	prop	label	v8	removed	❌
NcMentionBubble	title	prop	label	v8	removed	❌

---

2. Events — no rule handles events (entire category uncovered)

Component	Event	→ Replacement	v9 status	Covered
NcActionCheckbox / NcActionRadio	update:checked	update:model-value / v-model	removed	❌
NcActionInput / NcActionTextEditable / NcColorPicker / NcDateTimePicker / NcInputField / NcPasswordField / NcRichContenteditable / NcTextArea / NcTextField	update:value	update:model-value / v-model	removed	❌
NcDateTimePickerNative / NcSelect / NcTimezonePicker	input	update:model-value / v-model	removed	❌
NcColorPicker	close	closed	removed	❌
NcAppContent	resize:list	resize-list → resizeList	removed	❌
NcRichText	interact:todo	interact-todo	removed	❌
NcAppSidebar	opening	opened	removed	❌
NcAppSidebar	closing	closed	removed	❌
NcHeaderMenu	open / close / cancel	opened / closed	removed	❌

⚠️ The value/checked prop rule auto-fixes the attribute to v-model, but a template binding only the listener (@update:value, @input, :value.sync) without the prop is not detected.

---

3. Slots — no rule handles slots (entire category uncovered)

Component	Slot	→ Replacement	v9 status	Covered
NcInputField / NcTextField / NcPasswordField	leading icon slot #default	#icon	changed	❌
NcCounterBubble	default slot	(removed; count prop now required)	removed	❌

---

4. Components / exports / modules

Module	Entity	Kind	→ Replacement	v9 status	Covered
@nextcloud/vue/dist/*	dist import paths	import	@nextcloud/vue/<dir>/*	removed	✅
@nextcloud/vue/mixins/*	any mixin import	import	composables	removed	✅
directives/Tooltip	Tooltip directive	directive	native title / NcPopover	removed	✅
NcSettingsInputText	component import	component	alternatives	removed	✅
NcAppSettingsSectionShortcuts	re-export	component rename	NcAppSettingsShortcutsSection	deprecated	❌
functions/usernameToColor	default export	export	named export usernameToColor	removed	❌
composables/useFormatDateTime	useFormatDateTime	composable	useFormatTime / useFormatRelativeTime	removed	❌
composables/useIsMobile	isMobileState	export	useIsMobile	removed	❌
composables/useIsFullscreen	isFullscreenState	export	useIsFullscreen	removed	❌
Global plugin registration	Vue.use(...)	registration	local registration	removed	❌ (hard to lint statically)

---

5. Gap summary & priority

#	Gap	Category	Priority	Rationale
1	Nc*Field icon slot #default→#icon	slot	High	Silent breaking change, common, auto-fixable
2	Event renames (resize:list, interact:todo, close, opening/closing, open/close/cancel) + update:value/input/update:checked listeners	event	High	Largest fully-uncovered category
3	title→label (NcAutoCompleteResult, NcMentionBubble); button-variant/button-variant-grouped/label-hidden/legacy props	prop	Medium	Fit existing props rule directly
4	NcAppSettingsSectionShortcuts→NcAppSettingsShortcutsSection; usernameToColor default→named import	export	Medium	Fit existing exports rule
5	useFormatDateTime, isMobileState/isFullscreenState exports; global plugin registration	export	Low	Rarer; some not statically lintable