primeng p-cascadeSelect: `options` input type mismatch with official documentation.

Describe the bug

The CascadeComponent defines the options input as:

@Input() options: string[] | string | undefined | null; Source

However, the official documentation provides an example where options is expected to be an array of objects:

<p-cascadeSelect [(ngModel)]="selectedCity" [options]="countries" optionLabel="cname" optionGroupLabel="name" [optionGroupChildren]="['states', 'cities']" [style]="{ minWidth: '14rem' }" placeholder="Select a City"></p-cascadeSelect>

With the corresponding data:

this.countries = [
  {
    name: 'Australia',
    code: 'AU',
    states: [
      {
        name: 'New South Wales',
        cities: [
          { cname: 'Sydney', code: 'A-SY' },
          { cname: 'Newcastle', code: 'A-NE' },
          { cname: 'Wollongong', code: 'A-WO' }
        ]
      },
      {
        name: 'Queensland',
        cities: [
          { cname: 'Brisbane', code: 'A-BR' },
          { cname: 'Townsville', code: 'A-TO' }
        ]
      }
    ]
  },
  ...
];

Environment

Angular 16 PrimeNG 16

Reproducer

No response

Angular version

16.1.2

PrimeNG version

16.0.2

Build / Runtime

Angular CLI App

Language

TypeScript

Node version (for AoT issues node --version)

18

Browser(s)

No response

Steps to reproduce the behavior

No response

Expected behavior

The type definition for the options input should match the official documentation (or the other way around) and support arrays of objects. Or am I missing anything obvious here?

Aug 08 '23 19:08 Gykonik

Furthermore, I think that it needs undefined-checks for isOptionGroup:

isOptionGroup(option: string | object, level: number) {
  return Object.prototype.hasOwnProperty.call(option, (this.optionGroupChildren as string)[level]);
}

source

I think it should be as string[] or even as any as it was done in OptionGroupSub reference
This fails when not passing in any option for optionGroupChildren or passing a string.

Aug 09 '23 08:08 Gykonik

Any news about this?