-
Notifications
You must be signed in to change notification settings - Fork 57
chore(deps): update dependency typedoc to v0.28.3 #37
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Open
renovate
wants to merge
1
commit into
master
Choose a base branch
from
renovate/typedoc-0.x
base: master
Could not load branches
Branch not found: {{ refName }}
Loading
Could not load tags
Nothing to show
Loading
Are you sure you want to change the base?
Some commits from the old base branch may be removed from the timeline,
and old review comments may become outdated.
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
d81ced3 to
7668715
Compare
7668715 to
2c66b41
Compare
2c66b41 to
654e52d
Compare
20c4464 to
781cc9f
Compare
781cc9f to
c288250
Compare
c288250 to
0799e86
Compare
0799e86 to
b67b444
Compare
b67b444 to
f00c246
Compare
f00c246 to
e44f55a
Compare
e44f55a to
5ea9b5a
Compare
5ea9b5a to
4478c88
Compare
4478c88 to
61f6357
Compare
61f6357 to
ae73f59
Compare
ae73f59 to
9b8a9fa
Compare
5505c83 to
abd2fb2
Compare
abd2fb2 to
cab1e08
Compare
cab1e08 to
1001087
Compare
1001087 to
3daebe4
Compare
3daebe4 to
9e3351b
Compare
9e3351b to
1a81e46
Compare
1a81e46 to
83ed76b
Compare
83ed76b to
2065eba
Compare
2065eba to
291fb9c
Compare
291fb9c to
e5475e1
Compare
e5475e1 to
29c048b
Compare
29c048b to
7d914ea
Compare
7d914ea to
8368937
Compare
8368937 to
dfb7cef
Compare
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
This PR contains the following updates:
0.20.36->0.28.3Release Notes
TypeStrong/TypeDoc (typedoc)
v0.28.3Compare Source
Bug Fixes
@inlinenow functions when referencing tuple types, #2932.@linklinks to the current page are now rendered, #2934.@includeCodenow supports regions in TypeScript files with.mtsand.ctsfile extensions, #2935.v0.28.2Compare Source
Features
@group noneand@category nonewill now render their children without a sectionheading in the default theme, #2922.
@disableGroupstag to completely disable the grouping mechanism for agiven reflection, #2922.
Bug Fixes
@classnow correctly handle@category, #2914.@classnow include constructor parameters, #2914.@classwith a generic first constructor function now adoptthat function's type parameters as the class type parameters, #2914.
externalSymbolLinkMappingsoption when URL is set to#, #2921.@typedefnow correctly handle the constraint, #2929.toStringon types containing index signatures now behave correctly, #2917.@inlineTypeto the list of tags excluded by default.v0.28.1Compare Source
Features
TypeDocOptionsinterface now marks options as optional so it no longer has to be wrapped inPartialfor use in config files, #2901.
localStoragewithout clearing it, #2908.Bug Fixes
--watchcan now infer entry points frompackage.jsonas supported in non-watch mode, #2899.@includewith regions now works on files with CRLF line endings, #2902.module.exports = [], #2909../in relative links, #2910.Thanks!
v0.28.0Compare Source
Breaking Changes
/path separators, #2825.--entryPointStrategy mergemode now requires JSON from at least version 0.28.0.jptranslations fromlang, to migrate switch toja.intentionallyNotExportednow use a package name/package relative path instead of an absolute path for matching.source-ordersort ordering now considers package names / package relative paths instead of using the absolute paths to a file.package.jsonfile if--readmeis not setthis change improves handling of monorepo setups where some packages have readme files and others do not, #2875.
they are initialized with a function expression. TypeDoc can be instructed to convert them as functions
with the
@functiontag, #2881.to how interfaces are rendered, #2817.
API Breaking Changes
ProjectReflection.getReflectionFromSymbolandProjectReflection.getSymbolFromReflectionhave been moved toContextPathandPathArrayparameter types now always contain normalized paths.Routerwhich is used for URL creation.Reflection.url,Reflection.anchor, andReflection.hasOwnDocumenthave been removed.Deserializer.reviveProject(s)no longer accepts an option to add project documents.Deserializer.reviveProjectsnow requires analwaysCreateEntryPointModuleoption.Comment.serializeDisplayPartsno longer requires a serializer argument.ReflectionSymbolId.fileNameis now optional, TypeDoc now stores a combination of a package name and package relative path instead.The
fileNameproperty will be present when initially created, but is not serialized.DeclarationReflection.relevanceBoostattribute which was added for plugins, but never used.i18nproxy is no longer passed to many functions, instead, referencei18nexported from the module directly.ReflectionKind.singularStringandReflectionKind.pluralStringnow returns translated strings.The methods on
Internationalizationto do this previously have been removed.DefaultThemeRenderContext'stypeDeclarationandtypeDetailsIfUsefulmethods now require both a reflection and a type in order to support
@expandTypeFeatures
--routeroption which can be used to modify TypeDoc's output folderstructure. This can be extended with plugins, #2111.
@primaryExportmodifier tag to provide more fine grainedcontrol over export conversion order, #2856
packagesRequiringDocumentationoption forvalidation.notDocumented, TypeDoc will expect comments to be present for symbols in the specified packages.typedoc/browserentrypoint for parsing and using serialized JSON files, #2528.packageOptionsasPartial<TypeDocOptions>, #2878.packageOptions, #2878.@functiontag to force TypeDoc to convert variable declarations with a type annotation as functions, #2881.TypeDocglobal object in the HTML theme which can be used to prevent TypeDoc from usinglocalStorage, #2872.@preventInlineand@inlineTypetags for further control extending the@inlinetag, #2862.@preventExpandand@expandTypetags for further control extending the@expandtag, #2862.DefaultThemeRenderContext.reflectionIconfor more granular control over displayed reflection icons.Bug Fixes
Thanks!
v0.27.9Compare Source
This will be the last v0.27.x release, see #2868 for discussion on the 0.28 beta.
Features
v0.27.8Compare Source
Features
visibilityFilteroption now supports individual signatures, #2846.faviconoption may now be given a link starting withhttps?://instead of a path, #2851.#as the link inexternalSymbolLinkMappingsto indicate the type should not be linked to, #2853.Bug Fixes
undefined, #2854.Thanks!
v0.27.7Compare Source
Features
@includeCodeand@inlinecan now inject parts of files using regionnames or line numbers, #2816.
jatranslation options, deprecatedjpin favor ofja, #2843.--watchoption to support watching files not caught byTypeScript's watch mode, #2675.
@inlinetag now works in more places for generic types.Bug Fixes
@classincorrectly handling mapped types, #2842.so that declaration merged members with global symbols can be documented, #2844.
Thanks!
v0.27.6Compare Source
Features
ignoredHighlightLanguagesoption to specify languages which will beallowed in code blocks but not highlighted, #2819.
Bug Fixes
@includeand@includeCodenow work in the readme file, #2814.same symbol over type literal properties within function parameters.
v0.27.5Compare Source
Bug Fixes
deeply nested properties. This only affects links to properties of
properties of types, which did not have a clickable link exposed so are
unlikely to have been linked to. Furthermore, these links were not always
created by TypeDoc, only being created if all parent properties contained
comments, #2808.
rendered document and the parent property/page will be linked to instead,
#2808. These warnings can be disabled with the
validation.rewrittenLinkoption.
https://links under thehostedBaseUrloption's URL will nolonger be treated as external, #2809.
Thanks!
v0.27.4Compare Source
Features
Converter.EVENT_CREATE_PROJECTevent which fires when a project is created by the converter, #2800.Bug Fixes
@includeand@includeCodenow work for comments on the entry point for projects with a single entry point, #2800.@summarynow works to describe functions within modules, #2803.v0.27.3Compare Source
Features
Bug Fixes
highlightLanguagesoption now permits Shiki aliases to be specified rather than just the language ID, #2798.Thanks!
v0.27.2Compare Source
Bug Fixes
v0.27.1Compare Source
Bug Fixes
@categoryDescriptionand@groupDescriptionon module pages, #2787.v0.27.0Compare Source
Breaking Changes
result in a different file name structure, #2714.
have changed. They can be partially restored to the previous format by
setting
--sluggerConfiguration.lowercase false. This change was made tomore closely match the default behavior of GitHub's markdown rendering and
VSCode's autocomplete when creating a relative link to an external markdown
file.
hideParameterTypesInTitleoption, this was originally added asa workaround for many signatures overflowing the available horizontal space
in rendered pages. TypeDoc now has logic to wrap types/signatures smartly,
so this option is no longer necessary.
kindSortOrderto put references last.sortorder to usealphabetical-ignoring-documentsinstead of
alphabetical.suppressCommentWarningsInDeclarationFilestotrue(e.g.
X, notnew X)@group,@category,@groupDescriptionand@categoryDescriptionwill no longer be removed from the reflections they are present on. They are
skipped during rendering with the
notRenderedTagsoption.Features
package.jsonexports if theyare not provided manually, #1937.
#anchorlinks toreference a heading within them.
@paramcomments with nested object types, #2555.@paramcomments which reference a typealias/interface. Important properties on the referenced type can now be
highlighted with
@param options.foo, which will result in the additionalnote being included under the documentation for that parameter, #2147. Note:
This feature is limited to references. It is not supported on other types of
types.
outputsoption which is an array of outputs. This can be usedto render the documentation multiple times with different rendering options
or output types, #2597.
@expandtag which can be placed on type aliases andinterfaces. When a type with
@expandis referenced and TypeDoc has a placeto include additional details about the type, the properties of the type
will be included in the page where
@expandis found. Note that use of thistag can significantly increase the size of your generated documentation if
it is applied to commonly used types as it will result in inlining the
comments for those types everywhere they are referenced, #2303.
@inlinetag which can be placed on type aliases andinterfaces. When a type with
@inlineis referenced, TypeDoc will resolvethe referenced type and convert the type as if it was included directly
within the referencing type. Note that use of this tag can significantly
increase the size of your generated documentation if it is applied to
commonly used types as it will result in inlining the comments for those
types everywhere they are referenced, #2303.
@useDeclaredTypetag for type aliases which can sometimesimprove their documentation, #2654.
@mergeModuleWithtag which can be used to tell TypeDoc toplace a module/namespace's children under a different module/namespace and
remove the real parent, #2281.
@includeand@includeCodeinline tags to include files withincomments/documents.
notRenderedTagsoption. This option is similar to theexcludeTagsoption, but while
excludeTagswill result in the tag being completelyremoved from the documentation,
notRenderedTagsonly prevents it frombeing included when rendering.
groupReferencesByTypeoption.navigation.excludeReferencesoptionuseFirstParagraphOfCommentAsSummaryoption to configure how TypeDochandles comments for module members without the
@summarytag.faviconoption to specify a.icoor.svgfavicon to reference.together and will expand/collapse together, #2335.
app.outputsobject for defining new output strategies.@layer typedoc, #2782.Bug Fixes
readonlyindex signatures.overloads if present, #2718.
@enumif the type was declared before the variable, #2719.declared inside
declare global, #2774declare module "foo"as a module rather than a namespace, #2778.cases. This primarily affected destructured parameters.
yamlto the highlight languages supported by default.txtas an alias oftextto indicate a code blockshould not be highlighted.
@ignoreor@hiddenbut still referenced byother types will no longer produce warnings about not being exported.
module when resolving
@linktags.JavaScript is disabled.
rather than when converting. This prevents issues where boosts used by just
one package were incorrectly reported as unused when running with
entryPointStrategy set to packages.
Thanks!
v0.26.11Compare Source
Features
hostedBaseUrlis set to the root page on a website, TypeDoc will now includeWebSitestructured data, #2760.Bug Fixes
"module": "ESNext"and importing TypeDoc, #2747.v0.26.10Compare Source
Bug Fixes
v0.26.9Compare Source
Features
headingsoption to control optional headings, #2729.Bug Fixes
externalSymbolLinkMappingsnow uses the TypeScript reported link target if available, #2725.Thanks!
v0.26.8Compare Source
Features
<div>tags and includes the tag name in a class name, #2723.Bug Fixes
@linktags present in comments at the start of source files.ReflectionSymbolId.posno longer references the position before any doc comments for a symbol.This could cause typedoc-plugin-dt-links to produce links which didn't go to the expected location in a file.
Thanks!
v0.26.7Compare Source
Features
customJsoption to include a script tag in generated HTML output, #2650.markdownLinkExternaloption to treathttp[s]://links in markdown documents and comments as external to be opened in a new tab, #2679.navigation.excludeReferencesoption to prevent re-exports from appearing in the left hand navigation, #2685.@abstracttag, #2692.Bug Fixes
@linktags to symbols which are not included in the documentation will produce invalid link warnings again, #2681.@paramtags on comments attached to function callback parameters, #2683.alphabeticalandalphabetical-ignoring-documentssort options now uselocaleCompareto sort, #2684.thisparameter, #2698.Thanks!
v0.26.6Compare Source
Features
@extendsblock tag no longer produces warnings, #2659.This tag should only be used in JavaScript projects to specify the type parameters used when extending a parent class. It will not be rendered.
navigation.compactFoldersoption to prevent TypeDoc from compacting folders, similar to the VSCode option. #2667.Bug Fixes
suppressCommentWarningsInDeclarationFilesoption now correctly ignores warnings in.d.ctsand.d.mtsfiles, #2647.v0.26.5Compare Source
Features
OptionDefaults, #2640.Bug Fixes
@documentincludes an empty file, #2638.Thanks!
v0.26.4Compare Source
Bug Fixes
@linktags will now be validated in referenced markdown documents, #2629.@linktags are now resolved in project documents, #2629.@hiddenis now properly applied when placed in a function implementation comment, #2634.Thanks!
v0.26.3Compare Source
Features
Bug Fixes
mailto:links are no longer incorrectly recognized as relative paths, #2613.@sinceto the default list of recognized tags, #2614.v0.26.2Compare Source
Features
--suppressCommentWarningsInDeclarationFilesoption to disable warnings fromparsing comments in declaration files, #2611.
for members of interfaces/classes, #2084, #2545.
Bug Fixes
textnon-highlighted language no longer causes warnings when rendering, #2610.use an
@paramtag from the parent, TypeDoc will no longer warn about the@paramtag.v0.26.1Compare Source
Features
hostedBaseUrlis set to the root page on a website, TypeDoc will now includeWebSitestructured data, #2760.Bug Fixes
"module": "ESNext"and importing TypeDoc, #2747.v0.26.0Compare Source
Breaking Changes
markedtomarkdown-itfor parsing as marked has moved to an async model which supporting would significantly complicate TypeDoc's rendering code.This means that any projects setting
markedOptionsneeds to be updated to usemarkdownItOptions.Unlike
marked@4,markdown-itpushes lots of functionality to plugins. To use plugins, a JavaScript config file must be used with themarkdownItLoaderoption.As Shiki adds additional languages, the time it takes to load the highlighter increases linearly. To avoid rendering taking longer than necessary,
TypeDoc now only loads a few common languages. Additional languages can be loaded by setting the
--highlightLanguagesoption.--excludePrivatetotrue.--sitemapBaseUrlto--hostedBaseUrlto reflect that it can be used for more than just the sitemap.navigation.fullTreeoption.--mediaoption, TypeDoc will now detect image links within your comments and markdown documents and automatically copy them to the site.--includesoption, use the@documenttag instead.--stripYamlFrontmatteroption, TypeDoc will always do this now.--htmlLangoption to--lang.--gaIdoption for Google Analytics integration and correspondinganalyticstheme member, #2600.were always moved down to the signature level. This mostly worked, but caused problems with type aliases, so was partially changed in 0.25.13.
This change was extended to apply not only to type aliases, but also other function-likes declared with variables and callable properties.
As a part of this change, comments on the implementation signature of overloaded functions will now be added to the function reflection, and will
not be inherited by signatures of that function, #2521.
Converter.EVENT_CREATE_DECLARATIONwas emitted for
ProjectReflectionin some circumstances.MapOptionDeclaration.mapErrorhas been removed.BindOptiondecorator has been removed.DeclarationReflection.indexSignaturehas been renamed toDeclarationReflection.indexSignatures.Note: This also affects JSON serialization. TypeDoc will support JSON output from 0.25 through at least 0.26.
JSONOutput.SignatureReflection.typeParameterhas been renamed totypeParametersto match the JS API.DefaultThemeRenderContext.iconsCachehas been removed as it is no longer needed.DefaultThemeRenderContext.hookmust now be passedcontextif required by the hook.Features
--projectDocumentsoption to specify additional Markdown documents to be included in the generated site #247, #1870, #2288, #2565.are currently shipped in the package, but it is now possible to add support for additional languages, #2475.
packageOptionsobject which specifies options that should be applied to each entry point when running with--entryPointStrategy packages, #2523.--hostedBaseUrlwill now be used to generate a<link rel="canonical">element in the project root page, #2550.Note: This feature is only available on type aliases directly containing unions.
--customFooterHtmlto add custom HTML to the generated page footer, #2559.--cascadedModifierTagsoption, #2056.@alphaand@beta), #2056.@hideconstructortag.This tag should only be used to work around TypeScript#58653, prefer the more general
@hidden/@ignoretag to hide members normally, #2577.--useHostedBaseUrlForAbsoluteLinksoption to use the--hostedBaseUrloption to produce absolute links to pages on a site, #940.--blockTagsoption.documents-first,documents-last, andalphabetical-ignoring-documentsto order markdown documents.--alwaysCreateEntryPointModuleoption. When set, TypeDoc will always create aModulefor entry points, even if only one is provided.If
--projectDocumentsis used to add documents, this option defaults totrue, otherwise, defaults tofalse.--highlightLanguagesoption to control what Shiki language packages are loaded.This results in significantly smaller documentation pages in many cases where that section would just repeat what has already been presented in the rendered type.
comment.beforeTagsandcomment.afterTagshooks for plugin use.Combined with
CommentTag.skipRenderingthis can be used to provide custom tag handling at render time.Bug Fixes
Returnsheader are now properly colored, #2546.navigationLinksoption are now moved into the pull out navigation on mobile displays, #2548.@licenseand@importcomments will be ignored at the top of files, #2552.charsetis now correctly cased in<meta>tag generated by the default theme, #2568.<head>element could result in broken icons, #2589.@defaultand@defaultValueblocks are now recognized as regular blocks if they include inline tags, #2601.localStorage.--hideParameterTypesInTitleoption no longer applies when rendering function types.@linktags in readme files will now cause a warning when link validation is enabled.externalSymbolLinkMappingsoption's support for meanings in declaration references.type=buttonattribute set to avoid being treated as submit buttons.--hostedBaseUrlwill now implicitly add a trailing slash to the generated URL.Thanks!
v0.25.13Compare Source
Features
gitRevision:shortplaceholder option to--sourceLinkTemplateoption, #2529.Links generated by TypeDoc will now default to using the non-short git revision.
<footer>tag, addedfooter.beginandfooter.endrender hooks for use by custom plugins, #2532.
Bug Fixes
NoInfermissing type parameter reference, #2539."This member is normally hidden due to your filter settings" for every member.
Thanks!
v0.25.12Compare Source
Features
Bug Fixes
Thanks!
v0.25.11Compare Source
Bug Fixes
h1>h2>h3process, #2515.v0.25.10Compare Source
Bug Fixes
@interface, #2508.For TypeDoc's docs, this reduced the rendered documentation size by ~30%.
v0.25.9Compare Source
Features
Configuration
📅 Schedule: Branch creation - At any time (no schedule defined), Automerge - At any time (no schedule defined).
🚦 Automerge: Disabled by config. Please merge this manually once you are satisfied.
♻ Rebasing: Whenever PR becomes conflicted, or you tick the rebase/retry checkbox.
🔕 Ignore: Close this PR and you won't be reminded about this update again.
This PR was generated by Mend Renovate. View the repository job log.