feat(analyzer): ignore and internal jsdoc

[bennypowers]

fixes #21

[bennypowers]

It's likely i missed some test cases so please look over

custom-elements-manifest/packages/analyzer/fixtures/jsdoc-ignore-internal/package/my-element.js

Lines 1 to 38 in 6bd90a4

	/** @internal */
	export const dontIncludeMe = false; // should not be in declarations
	/** @ignore */
	export const meNeither = false; // should not be in declarations
	export const variable = 'var';
	/** @ignore */
	export class IgnoreMe extends HTMLElement { }
	customElements.define("ignore-me", IgnoreMe);
	export class IncludeMe extends HTMLElement {
	included = 'hello world';
	/** @ignore */
	sneaky = 'deaky';
	/** @internal */
	hideMe() {
	return '🙈'
	}
	}
	customElements.define("include-me", IncludeMe);
	/** @ignore */
	var ignoreMePlease = 'haha';
	/** @internal */
	var excludeMe, andMe = 'something private';
	export {
	ignoreMePlease,
	excludeMe,
	andMe,
	}

[netlify]

❌ Deploy Preview for custom-elements-manifest-analyzer failed.

🔨 Explore the source changes: cafb94d

🔍 Inspect the deploy log: https://app.netlify.com/sites/custom-elements-manifest-analyzer/deploys/60eab3f0b0a21f0008810cd5

[thepassle]

we already had an open PR for this that was almost finished here #22

[bennypowers]

Ok I covered the case from #22 (comment) as well

[bennypowers]

I think this is ready to go can you check the test cases please?

[thepassle]

Maybe we should revisit the approach we had in this PR #22, it solved like 99% of the cases with like 5 lines of code. The only case that needed to be fixed was:

class MyEl extends HTMLElement {
  priv2;

  constructor() {
    super();

    /** @ignore */
    this.priv2 = 'hidden';
  }
}

[bennypowers]

PR #22, it solved like 99% of the cases with like 5 lines

Unfortunately the previous PR, though brief, did not cover nearly enough cases to be useful, which is why I closed the previous in favour of this one. The reason this PR has to touch so many files is because in many of the handlers, there's no way to remove the doc in question without causing reference errors down the pipeline, hence the inclusion of null checks at assignment expressions throughout the core, which I think is anyways a good idea.

Test failures on previous branch

[thepassle]

Those test failures dont seem correct? The implementation in the other branch correctly excluded variables, classes, fields. You're correct that it didnt handle custom-element-definitions and @internal yet but that would have been trivial to add

[bennypowers]

ok i'll give it another look maybe we can have it all