feat: Docs dependencies should include Mixins

[janerikmai]

Prerequisites

• I have read the Contributing Guidelines.
• I agree to follow the Code of Conduct.
• I have searched for existing issues that already report this problem, without success.

Framework Output Target

Multiple / Other

Output Target Version

0.0.0

Stencil Version

4.43.5

Reproduction URL

https://codesandbox.io/p/devbox/stencil-docs-dependencies-with-mixins-forked-73cjvp

Describe the Bug

Having a mixin FormElementMixin. This has a method renderValidation that will render the component my-validation (class MyValidation).

Now having class MyInput extends Mixin(FormElementMixin) using the renderValidation method from FormElementMixin.

Running build with type docs-json I would have expected that MyInput somehow lists MyValidation as indirect dependency. But the dependencies node is empty. I assume the static analyzer is missing some deeper checks or my understanding of dependencies here is wrong.

Steps to Reproduce

Go Sandbox,

look docs.json in root

Expected Behavior

I would expect the analyzer does recognize the method call from extended class that renders the other component in my current component, so I expect docs.json for this component has a dependencies node listing the other component for the current.

Additional Context

No response

Logs

[johnjenkins]

hi - thanks for raising 🙏
docs dependencies have never been for mixins - mixins are seen as more of an internal implementation detail rather than something that needs public documentation.

Instead, dependencies are for direct component render deps. e.g. my-form renders my-input in it's jsx. This is important public information for end users to know:

• they may need to make sure the nested component is imported / defined before using the parent component
• they may be able to style the nested component with forwarded parts and css-vars
• a developer may have made the nested component configurable via a prop
  etc

I've changed this issue to be a feature-request. To that end, please can you explain your use-case and need for this - ty