[FEATURE] jsdoc: Support destructuring of enums for defaultValue

[d3xter666]

JIRA: CPOUI5FOUNDATION-503

This PULL request tries to enable ES6+ destructuring for UI5 enums.

There might be different cases and ways to achieve this and with this change, we try to cover the ones we already know. (Note: There might be more we're not aware of).

Here are the cases we try to cover:

1. Destructuring from fully quantified name

// shortcut for sap.ui.core.TitleLevel
var {TitleLevel} = sap.ui.core;

1. Destructuring from fully quantified name

// shortcut for sap.ui.core.TitleLevel
var {TitleLevel} = sap.ui.core;

2. Chained destructuring

const library = {
  MyEnum: {
    Foo: "FooValue",
  },
};


const { MyEnum } = library;
const { Foo } = MyEnum;

3. Destructuring with a rename

 const { Foo: Bar } = MyEnum; 

4. Destructuring as an argument of an arrow function

sap.ui.define([
	"sap/ui/core/Control", 
	"./library"
], (Control, { MyEnumFromLib } ) => {
...
});

5. Not a destructuring, but a pattern close to # 3 and already covered by the builder. However, we need to be aware of it and should consider it as the chain in AST is (almost) the same as the one in # 3

var MyTitleLevelVar = sap.ui.core.TitleLevel;

6. Any mixtures from the cases above

[coveralls]

Coverage decreased (-0.01%) to 94.703% when pulling fd369cf on es6-enum-destructuring into 36a99f5 on main.

[d3xter666]

This is the case where the ENUM could be just the element.

For example, const { TitleLevel } = sap.ui.core;

[matz3]

I only briefly looked through the code, but will need to run it locally to fully verify the resolve logic

outdated