fix(Webpack dev-server build warning): Create false value alias for `moment-with-locales`

[rtexelm]

SUMMARY

This is a workaround to suppress the ./locale build warning when using the webpack dev-server involving a well documented (more reports) bug in the now defunct moment library. This is meant to remove the warning, anticipating a migration away from moment in the future.

Example warning

WARNING in ./node_modules/moment/min/moment-with-locales.js 2159:16-50
Module not found: Error: Can't resolve './locale' in 'superset-frontend/node_modules/moment/min'

BEFORE/AFTER SCREENSHOTS OR ANIMATED GIF

TESTING INSTRUCTIONS

ADDITIONAL INFORMATION

• [ ] Has associated issue:
• [ ] Required feature flags:
• [ ] Changes UI
• [ ] Includes DB Migration (follow approval process in SIP-59)
  • [ ] Migration is atomic, supports rollback & is backwards-compatible
  • [ ] Confirm DB migration upgrade and downgrade tested
  • [ ] Runtime estimates and downtime expectations provided
• [ ] Introduces new feature or API
• [ ] Removes existing feature or API

[jrushlow]

Psalm is emitting this because Doctrine\ORM\EntityRepository::findAll() has a return type of list<T> which ultimately is translated by psalm to array<int, Foo>. Where as the @method Link[] findAll() return type is ultimately translated by psalm to @psalm-return array<array-key, ValueType>

I believe changing @method return signatures to array<int, Link> (I cant remember if this syntax is legitimate) would squash this squawk from psalm. It does however look less appealing when you end up with:

/**
 * @method Link|null find($id, $lockMode = null, $lockVersion = null)
 * @method Link|null findOneBy(array $criteria, array $orderBy = null)
 * @method array<int, Link>[]  findAll()
 * @method Link[]    findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 */
class LinkRepository extends ServiceEntityRepository

Then, depending on your rule set, php-cs-fixer would complain about the column alignment in that docBlock and adjust accordingly..

/**
 * @method Link|null         find($id, $lockMode = null, $lockVersion = null)
 * @method Link|null         findOneBy(array $criteria, array $orderBy = null)
 * @method array<int, Link>  findAll()
 * @method Link[]            findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 */
class LinkRepository extends ServiceEntityRepository

Personally, I ignore this particular error in my psalm.xml or baseline file. That approach is not ideal but I'm not sure what the best approach to keeping psalm silent is. Open to ideas!

Perhaps a stub in https://github.com/psalm/psalm-plugin-symfony?

[christian-kolb]

@ThomasLandauer @jrushlow Is there a way to define T in list<T> in our own repositories? That would solve the problem and would lead to us not needing to define @method in the first place.

[jrushlow]

@christian-kolb I'm sure there is - https://psalm.dev/docs/annotating_code/templated_annotations/ has more information on template annotations. If it is possible for us to do that in a clean manner without any adverse effects - PR's welcome..

[christian-kolb]

I guess there would be changes in the ServiceEntityRepository which is part of Doctrine, isn't it?

[jeckel]

Here is the syntax I use to be compatible with most cases:

Specify the template with by entity with @extends

Specify a signature dedicated to Psalm with @psalm-method

/**
 * @extends ServiceEntityRepository<Link>
 * @method Link|null find($id, $lockMode = null, $lockVersion = null)
 * @method Link|null findOneBy(array $criteria, array $orderBy = null)
 * @psalm-method list<Link> findAll()
 * @method Link[] findAll()
 * @psalm-method list<Link> findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 * @method Link[] findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 */
class LinkRepository extends ServiceEntityRepository

[abdounikarim]

@weaverryan can we just remove these comments from the generation ?

There is no psalm error without these.

[kissifrot]

Or we can (optionally) add psalm-ones to the generation, no?

[badmansan]

Here is the syntax I use to be compatible with most cases:

Specify the template with by entity with @extends

Specify a signature dedicated to Psalm with @psalm-method

/**
 * @extends ServiceEntityRepository<Link>
 * @method Link|null find($id, $lockMode = null, $lockVersion = null)
 * @method Link|null findOneBy(array $criteria, array $orderBy = null)
 * @psalm-method list<Link> findAll()
 * @method Link[] findAll()
 * @psalm-method list<Link> findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 * @method Link[] findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 */
class LinkRepository extends ServiceEntityRepository

This work on level 4+, but cause InvalidDocblock error on level 3

[lsv]

The only method I could get down to level 1 was to add @psalm-suppress

/**
 * @psalm-suppress MethodSignatureMustProvideReturnType
 * @psalm-suppress LessSpecificImplementedReturnType
 *
 * @extends ServiceEntityRepository<Round>
 *
 * @method Round|null find($id, $lockMode = null, $lockVersion = null)
 * @method Round|null findOneBy(array $criteria, array $orderBy = null)
 * @method Round[]    findAll()
 * @method Round[]    findBy(array $criteria, array $orderBy = null, $limit = null, $offset = null)
 */
class RoundRepository extends ServiceEntityRepository

Ofcourse its not perfect, but it gets the job done, it will properly also be a problem when you add your own find methods, which will not be static analyzed either.