Is your feature request related to a problem? Please describe.
Right now widget_pages cannot have nested widget_pages, this is, the folder containing the index.md file with type: "widget_page" in its front matter cannot have subfolders (subsections).
Describe the solution you'd like
Following this comment, it'd be great if widget_pages could have subfolders inside with more widget_pages (essentially becoming branch bundles instead of leaf bundles).
Describe alternatives you've considered
One can make those widget_pages sections of the main widget_page but that can have a negative impact on the performance, as seen in #1992.
Additional context
This is an example of a folder structure I'm willing to have:
│
└───folder1
│ │ some widgets
│ │
│ └───subfolder1
│ │ more widgets
The more I read the more convinced I am that widget_pages should definitely be sections (https://gohugo.io/content-management/sections/). Recent versions of Hugo allow for build options that may help here.
Great suggestion @rodrigoalcarazdelaosa !
A year or more ago, I experimented with nested Widget Pages, but Hugo did not have the capability to support it without undesired side effects at the time.
However, from Hugo v0.68.0+ (and recent bug fixes), Hugo's new _build and cascade options appear to enable a refactor of widget pages in a way which would allow for nested Widget Pages without any undesired side effects 😃
This requires further investigation and likely there will be some breaking changes.
As a temporary workaround to the problem you presented with breaking up a long widget page into multiple nested widget pages, perhaps it may be possible to create folders for multiple widget pages within the same parent folder (i.e. not nested) and then use Hugo's permalink option to effectively nest them inside each other?
Somewhat related to this (if not I'm happy opening a new feature request). Right now the portfolio widget cannot use (show) content that is in the same folder of the widget itself (which must be a widget_page) or inside any subfolder. Ideally I'd love to have a folder working as a widget_page with a portfolio widget that'd be showing projects located in subfolders inside that widget_page (see image attached). That way the url of those projects would have the same structure created with the widgets.

As a temporary workaround to the problem you presented with breaking up a long widget page into multiple nested widget pages, perhaps it may be possible to create folders for multiple widget pages within the same parent folder (i.e. not nested) and then use Hugo's permalink option to effectively nest them inside each other?
I hadn't thought about this @gcushen and it's working out beautifully! Actually I'm achieving the same end result as with nested widget_pages. These obviously would be much more convenient, as I wouldn't need to manually define the url of all my pages, but in the meantime I'm very very happy!
After further investigation, the optimal approach for now is to keep Widget Pages as standard "pages" (aka "page bundles") in Hugo, rather than convert them to Hugo's multi-page "branch bundle" concept. This is aligned with the plan for Widget Pages v2 and closer CMS integration.
Widget pages can be nested by creating them in a flat structure and then nesting them via permalinks, as described above. Perhaps Hugo will provide first-class support for nested pages (aka "page bundles") in the future.
Most helpful comment
I hadn't thought about this @gcushen and it's working out beautifully! Actually I'm achieving the same end result as with nested
widget_pages. These obviously would be much more convenient, as I wouldn't need to manually define theurlof all my pages, but in the meantime I'm very very happy!