Merge branch 'main' into fix-dnd-folder-contents

Author: Tishasoumya-02

.github/ISSUE_TEMPLATE/2_feature_request.md

@@ -2,7 +2,7 @@
 name: '🦄 Feature request'
 about: 'Suggest an idea for Volto'
 title: ''
-labels: '04 type: enhancement'
+labels: ['04 type: enhancement', '30 needs: triage']
 assignees: ''
 ---
 

README.md

@@ -147,7 +147,7 @@ To ensure your website gets the greatest exposure, add it both to [Awesome Volto
 - [Geosphere Austria](https://www.geosphere.at/de) (Website of the Austrian Federal Institute, national geological, geophysical, climatological and meteorological service, 2023)
 - [German Aerospace Center (DLR)](https://www.dlr.de/de) (The German Aerospace Center (DLR) is the Federal Republic of Germany's research center for aeronautics. With more than 10.000 employees and a yearly budget of more than 1 billion euros, it is one of the largest research institutions in Germany, developed by [kitconcept GmbH](https://kitconcept.com/en), 2023)
 - [Helmholtz-Institut Erlangen-Nürnberg für Erneuerbare Energien (HI-ERN)](https://www.hi-ern.de/de) (Website for HI ERN, a research institution for renewable energies, developed by [kitconcept GmbH](https://kitconcept.com/en), 2022)
-- [Humboldt Labor](https://www.humboldtforum.org/de/programm/dauerangebot/ausstellung/nach-der-natur-14144/) (The Humboldt Lab is a website where the Humboldt University Berlin presents its latest research projects and findings. Developed by [WLDX](https://wldx.de/) and [kitconcept GmbH](https://kitconcept.com/en), 2020)
+- [Humboldt Labor](https://www.humboldtforum.org/de/programm/dauerangebot/ausstellung/nach-der-natur-14144/) (The Humboldt Lab is a website where the Humboldt University Berlin presents its latest research projects and findings. Developed by WLDX (a joint venture of [WAALD](https://www.waald.com/) and [CDLX](https://cdlx.de/)) and [kitconcept GmbH](https://kitconcept.com/en), 2020)
 - [ILPO](https://ilpo.jyu.fi/) (the registration portal of continuous learning at the University of Jyväskylä. Developed by University of Jyväskylä, 2022)
 - [Industrial Emissions portal for Europe](https://industry.eea.europa.eu) (Thematic website focusing on European industrial emissions, developed by [Eau de Web](https://eaudeweb.ro/), 2020)
 - [Interpretare.ro](https://www.interpretare.ro) (Romanian medical imaging interpretation service allowing patients to submit MRI, CT, and other diagnostic imaging for professional evaluation by medical specialists, 2022)

docs/source/conf.py

@@ -87,6 +87,7 @@
     r"http://localhost",
     # Ignore pages that require authentication
     r"https://github.com/plone/volto/issues/new/choose",  # requires auth
+    r"https://javascript.plainenglish.io/you-dont-need-lodash-how-i-gave-up-lodash-693c8b96a07c",
     r"https://www.npmjs.com",
     # Ignore github.com pages with anchors
     r"https://github.com/.*#.*",

docs/source/reference/index.md

@@ -15,4 +15,5 @@ This section of the documentation contains reference guides for various aspects
 :maxdepth: 1
 
 widgets
+utilities
 ```

docs/source/reference/utilities.md

@@ -0,0 +1,54 @@
+---
+myst:
+  html_meta:
+    "description": "How to type Volto utilities via UtilityTypeMap"
+    "property=og:description": "How to type Volto utilities via UtilityTypeMap"
+    "property=og:title": "Typing utilities"
+    "keywords": "Volto, Plone, utilities, typing, TypeScript"
+---
+
+# Typing utilities
+
+`registerUtility`, `getUtility`, and `getUtilities` now bind their method signatures to the utility `type`. You can declare the expected method shape for a given type using the `UtilityTypeMap` interface from `@plone/types`.
+
+## Declare utility method types
+
+Extend `UtilityTypeMap` via module augmentation (for example in `src/types/volto.d.ts`):
+
+```ts
+// src/types/volto.d.ts
+declare module '@plone/types' {
+  interface UtilityTypeMap {
+    rootContentSubRequest: (options: { path: string }) => Promise<unknown>;
+    // Add more utility types here
+  }
+}
+```
+
+## Typed registry usage
+
+Once declared, utilities of that `type` are strongly typed:
+
+```ts
+import config from '@plone/registry';
+
+config.registerUtility({
+  name: 'rootContent',
+  type: 'rootContentSubRequest',
+  method: async ({ path }) => fetch(path).then((res) => res.json()),
+});
+
+const { method } = config.getUtility({
+  name: 'rootContent',
+  type: 'rootContentSubRequest',
+});
+
+// method is (options: { path: string }) => Promise<unknown>
+method({ path: '/news' });
+```
+
+`getUtilities({ type: 'rootContentSubRequest' })` returns an array whose `.method` matches the declared signature.
+
+## Fallback for unknown types
+
+Utility types you do not declare in `UtilityTypeMap` stay permissive and accept `(...args: any[]) => any`, preserving backward compatibility.

docs/source/release-notes/index.md

@@ -17,6 +17,31 @@ myst:
 
 <!-- towncrier release notes start -->
 
+## 19.0.0-alpha.20 (2025-12-21)
+
+### Bugfix
+
+- Hide date and time fields when either "Whole Day" or "Open End" is checked in the Event form. @wesleybl [#3243](https://github.com/plone/volto/issues/3243)
+- Fixed a bug in the login form where the user could see a spinner instead of an error message after a failed login, when the login form was loaded via server-side rendering. @aryan7081 [#7397](https://github.com/plone/volto/issues/7397)
+- Fix max filesize upload issue in drag and drop @Tishasoumya-02 [#7695](https://github.com/plone/volto/issues/7695)
+- Fix multilingual redirect for languages using locale-specific formats. @Shyam-Raghuwanshi [#7725](https://github.com/plone/volto/issues/7725)
+- Add German translations for the current and parent paths. @iFlameing 
+- Add support for typing and pasting URLs in the ObjectBrowserWidget for location selection in the Listing block. @iFlameing 
+
+### Internal
+
+- Refactored the `FormFieldWrapper` widget by converting it from a class-based component to a modern functional component using React hooks. @Manik-Khajuria-5 [#7672](https://github.com/plone/volto/issues/7672)
+- Update TypeScript types for Volto. @wesleybl [#7703](https://github.com/plone/volto/issues/7703)
+- Include other *.md files in the repo root for link checking, fix redirecting links, and remove non-responsive server. @stevepiercy [#7712](https://github.com/plone/volto/issues/7712)
+- Update actions/checkout to v5 in all GitHub Actions workflows. @wesleybl [#7724](https://github.com/plone/volto/issues/7724)
+- Update actions/cache from v4 to v5 in GitHub Actions workflow files. @wesleybl [#7731](https://github.com/plone/volto/issues/7731)
+- Sync react-aria-components to 1.14.0 in catalog.json and nextjs package.json. @wesleybl [#7733](https://github.com/plone/volto/issues/7733)
+
+### Documentation
+
+- Add Volto 19 add-on development documentation. @Shyam-Raghuwanshi [#7694](https://github.com/plone/volto/issues/7694)
+- Exclude `linkedin.com` from link checker. @davisagli 
+
 ## 19.0.0-alpha.19 (2025-12-08)
 
 ### Feature

packages/components/news/+fixRAC1.14.0.internal

@@ -8,6 +8,12 @@
 
 <!-- towncrier release notes start -->
 
+## 3.0.0-alpha.9 (2025-12-22)
+
+### Feature
+
+- Enhance registry utilities type definitions with typed method signatures. @ompharate @sneridagh [#7652](https://github.com/plone/volto/issues/7652)
+
 ## 3.0.0-alpha.8 (2025-11-03)
 
 ### Breaking

packages/registry/CHANGELOG.md

@@ -9,7 +9,7 @@
   ],
   "funding": "https://github.com/sponsors/plone",
   "license": "MIT",
-  "version": "3.0.0-alpha.8",
+  "version": "3.0.0-alpha.9",
   "repository": {
     "type": "git",
     "url": "https://github.com/plone/volto.git"

packages/registry/package.json

@@ -15,6 +15,8 @@ import type {
   WidgetsConfig,
   ReactRouterRouteEntry,
   WidgetKey,
+  UtilityTypeMap,
+  Utility,
 } from '@plone/types';
 
 export type ConfigData = {
@@ -35,8 +37,12 @@ type GetComponentResult = {
   component: React.ComponentType<any>;
 };
 
-type GetUtilityResult = {
-  method: (...args: any[]) => any;
+type UtilityMethodFor<Type extends string> = Type extends keyof UtilityTypeMap
+  ? UtilityTypeMap[Type]
+  : (...args: any[]) => any;
+
+type GetUtilityResult<Type extends string = string> = {
+  method: UtilityMethodFor<Type>;
 };
 
 export type ConfigType = InstanceType<typeof Config>;
@@ -459,11 +465,11 @@ class Config {
     }
   }
 
-  registerUtility(options: {
+  registerUtility<Type extends string>(options: {
     name: string;
-    type: string;
+    type: Type;
     dependencies?: Record<string, string>;
-    method: (args: any) => any;
+    method: UtilityMethodFor<Type>;
   }) {
     const { name, type, method, dependencies = {} } = options;
     let depsString: string = '';
@@ -477,19 +483,19 @@ class Config {
     }
     const utilityName = `${depsString ? `|${depsString}` : ''}${name}`;
 
-    let utilityType = this._data.utilities[type];
+    let utilityType = this._data.utilities[type] as Utility<Type> | undefined;
     if (!utilityType) {
-      this._data.utilities[type] = {};
-      utilityType = this._data.utilities[type];
+      this._data.utilities[type] = {} as Utility<Type>;
+      utilityType = this._data.utilities[type] as Utility<Type>;
     }
     utilityType[utilityName] = { method };
   }
 
-  getUtility(options: {
+  getUtility<Type extends string>(options: {
     name: string;
-    type: string;
+    type: Type;
     dependencies?: Record<string, string>;
-  }): GetUtilityResult | Record<string, never> {
+  }): GetUtilityResult<Type> | Record<string, never> {
     const { name, type, dependencies = {} } = options;
 
     if (!name || !type) return {};
@@ -500,14 +506,17 @@ class Config {
       .join('+');
 
     const utilityName = `${depsString ? `|${depsString}` : ''}${name}`;
+    const utilitiesForType = this._data.utilities[type] as
+      | Utility<Type>
+      | undefined;
 
-    return this._data.utilities[type]?.[utilityName] || {};
+    return utilitiesForType?.[utilityName] || {};
   }
 
-  getUtilities(options: {
-    type: string;
+  getUtilities<Type extends string>(options: {
+    type: Type;
     dependencies?: Record<string, string>;
-  }): Array<GetUtilityResult> | [] {
+  }): Array<GetUtilityResult<Type>> | [] {
     const { type, dependencies = {} } = options;
 
     if (!type) return [];
@@ -517,13 +526,16 @@ class Config {
       .map((key) => `${key}:${dependencies[key]}`)
       .join('+');
 
+    const utilitiesForType = this._data.utilities[type] as
+      | Utility<Type>
+      | undefined;
+    if (!utilitiesForType) return [];
+
     const utilityName = `${depsString ? `|${depsString}` : ''}`;
-    const utilitiesKeys = Object.keys(this._data.utilities[type] || {}).filter(
-      (key) => key.startsWith(utilityName),
-    );
-    const utilities = utilitiesKeys.map(
-      (key) => this._data.utilities[type][key],
+    const utilitiesKeys = Object.keys(utilitiesForType).filter((key) =>
+      key.startsWith(utilityName),
     );
+    const utilities = utilitiesKeys.map((key) => utilitiesForType[key]);
 
     return utilities;
   }