TypeDoc should export sufficient values to set options without importing internals

[Gerrit0]

Currently (0.16.1) TypeDoc doesn't export all the enums required to set options with type checking. SourceFileMode (and possibly other enums) are missing from the root level export.

All options should export sufficient types + values to be able to be set.

Also export TypeDocAndTypeScriptOptions + friends as they are missing.

[socsieng]

Is this also the reason for not being able to create custom options using the @Option decorator?

Custom options fail because they don't meet the following criterial: function Option<K extends keyof TypeDocOptionMap>(option: { name: K } & KeyToDeclaration<K>)

[Gerrit0]

The @Option decorator is more strictly typed since it was intended for internal use, I'd be open to a request to make the types more lax with an overload (like addDeclaration) so that external consumers can use it though.

Alternatively, maybe we should encourage plugin developers to add their options to the TypeDocOptionMap via declaration merging and then the types on addDeclaration can be made more strict.

[Gerrit0]

Looking at this:

typedoc/src/lib/utils/options/declaration.ts

Line 42 in 7152031

mode: typeof SourceFileMode;

This is wrong. I think it should be { file: SourceFileMode.File, modules: SourceFileMode.Modules }

[socsieng]

The @Option decorator is more strictly typed since it was intended for internal use, I'd be open to a request to make the types more lax with an overload (like addDeclaration) so that external consumers can use it though.

That explains #1165

+1 for making @Option available for use externally. I would prefer this option over declaration merging.

[Gerrit0]

Fixed in 0.16.2