chore: prepare v8.20.0 release

[Antreesy]

v8.20.0 (2024-10-29)

Full Changelog

📝 Notes

Now you can use v-model directive, :model-value prop, and @update:model-value (@update:modelValue) event in all data input components to have compatibility with v9 in the future.

<!-- Only v8 (Vue 2) -->
<NcTextField :value.sync="username" />
<!-- Compatible with both v8 (Vue 2) and v9 (Vue 3) -->
<NcTextField v-model="username" />
<!-- same as -->
<NcTextField :model-value="username" @update:model-value="username = $event" />

If you already use v-model with a custom writable computed on :value.sync components before, it might not work as expected anymore. Make sure to remove or adjust it before update.
See the full list in v9 breaking changes.

🚀 Enhancements

• feat: add v-model support for input-like components #5418 (kyteinsky)
• feat: forward compatibility with v9 on v-model props/events #6172 (ShGKme)
• feat(NcRichText): add styles to mount point for custom picker and custom widget elements #6108 (julien-nc)
• feat(NcRichText): make interactive widgets opt-in #6151 (Antreesy)

🐛 Fixed bugs

• fix(NcReferencePicker): allow closing modal dialog #6137 (JuliaKirschenheuter)
• fix(NcActions): RTL support #6148 (hamza221)
• fix(NcAppNavigation): RTL support #6144 (hamza221)
• fix(NcSelect): RTL support #6150 (hamza221)
• fix(NcAppDetailsToggle): RTL support #6145 (hamza221)
• fix(NcModal): RTL support #6171 (hamza221)
• fix(NcAppSidebar): RTL support #6187 (hamza221)
• fix(NcDateTimePicker): adjust component styling close to native appearance #6095 (GretaD)
• fix(NcTimeZonePicker): scope css styles #6184 (Antreesy)
• fix(NcAppSidebarTabs): force color-main-text for icons #6189 (Antreesy)
• fix(NcAppNavigationItem): use $scopedSlots instead of $slots #6161 (st3iny)

Changed

• Updated workflows and dependencies
• Updated translations

[Antreesy]

Using of event.target.value now fails for inputs:

<NcTextField v-model="computedProp"/>

computedProp: {
	set(event) {
		this.updateValue(event.target.value)
	},
},

as it emits 'update:value', event.target. value instead:

<NcTextField v-model="computedProp"/>

computedProp: {
	set(value) {
		this.updateValue(value)
	},
},

Should we consider it a breaking change?

[julien-nc]

@Antreesy Yes it's a breaking change IMO.

[ShGKme]

Should we consider it a breaking change?

I wouldn't call it a breaking change. This is invalid usage, component didn't have documented v-model, direct (correct) usage of v-model didn't work. It had different kind of value on get and set.

[ShGKme]

• feat: add v-model support for input-like components #5418 (kyteinsky)

Would be good to combine with #6172

Then it actually has almost no breaking change with v9 in one step

[Antreesy]

This is invalid usage

I have to check, if :value.sync is also affected by it

Would be good to combine with #6172

Waiting for you then

[susnux]

I have to check, if :value.sync is also affected by it

Also would consider this unexpected / undocumented / invalid behavior.
value.sync should return the synced value, not the keyboard event. For that there is the input event.

[ShGKme]

:value.sync would only be affected if update:value event payload was changed. New model option only affects v-model directive.

[Antreesy]

Waiting for:

• fix(NcAppSidebarTabs): force color-main-text for icons #6189
• fix(NcAppSidebar): RTL support #6187
• feat: forward compatibility with v9 on v-model props/events #6172
• fix(NcTimeZonePicker): scope css styles #6184

[Antreesy]

:value.sync would only be affected if update:value event payload was changed. New model option only affects v-model directive.

Tested.

1. :value + @input emits ('update:value', event.target.value)
2. :value.sync emits ('update:value', newValue)

v-model before this release worked as p.1, now as p.2. I'd skip mentioning it in changelog as undocumented feature, that shouldn't suppose to work before.

[susnux]

Would also add the note @ShGKme proposed.

[ShGKme]

Has been merged:

• feat: add isDarkTheme functions and composables #5698

On review:

• feat: Add spawnDialog function #6195