Return a child by its name.
The name hierarchy of the child to look for.
The found child or undefined.
Return a list of all children of a certain kind.
The desired kind of children.
An array containing all children with the desired kind.
Return the full name of this reflection, with signature names dropped if possible without introducing ambiguity in the name.
Return the full name of this reflection. Intended for use in debugging. For log messages intended to be displayed to the user for them to fix, prefer getFriendlyFullName instead.
The full name contains the name of this reflection and the names of all parent reflections.
Separator used to join the names of the reflections.
The full name of this reflection.
Gets the reflection registered for the given reflection ID, or undefined if it is not present in the project.
InternalGets the reflection associated with the given symbol id, if it exists. If there are multiple reflections associated with this symbol, gets the first one.
Return a list of all reflections in this project of a certain kind.
The desired kind of reflection.
An array containing all reflections with the desired kind.
Checks if this reflection has a comment which contains any visible text.
OptionalnotRenderedTags: readonly `@${string}`[]TRUE when this reflection has a visible comment.
Check if this reflection or any of its parents have been marked with the @deprecated tag.
Return whether this reflection is the root / project reflection.
Test whether this reflection is of the given kind.
InternalRegisters the given reflection so that it can be quickly looked up by helper methods. Should be called for every reflection added to the project.
Note: During conversion, Context.registerReflection should be used instead so
that symbols can be saved for later use.
Removes a reflection from the documentation. Can be used by plugins to filter reflections out of the generated documentation. Has no effect if the reflection is not present in the project.
Set a flag on this reflection.
Return a string representation of this reflection.
Return a string representation of this reflection and all of its children.
Note: This is intended as a debug tool only, output may change between patch versions.
Used internally to indent child reflections.
Traverse most potential child reflections of this reflection.
Note: This may not necessarily traverse child reflections contained within the type property
of the reflection, and should not be relied on for this. Support for checking object types will likely be removed in v0.29.
The given callback will be invoked for all children, signatures and type parameters attached to this reflection.
The callback function that should be applied for each child reflection.
ReadonlyfilesObject which describes where to find content for relative links.
Unique id of this reflection.
The kind of this reflection.
The symbol name of this reflection.
A list of all reflections within the project. DO NOT MUTATE THIS OBJECT. All mutation should be done via registerReflection and removeReflection to ensure that links to reflections remain valid.
This may be replaced with a Map<number, Reflection> someday.
ReadonlyvariantDiscriminator representing the type of reflection represented by this object.
OptionalcategoriesAll children grouped by their category.
OptionalchildrenThe children of this reflection. Do not add reflections to this array manually. Instead call addChild.
OptionalchildrenOptionalcommentThe parsed documentation comment attached to this reflection.
OptionaldocumentsDocuments associated with this reflection.
These are not children as including them as children requires code handle both types, despite being mostly unrelated and handled separately.
Including them here in a separate array neatly handles that problem, but also introduces another one for rendering. When rendering, documents should really actually be considered part of the "children" of a reflection. For this reason, we also maintain a list of child declarations with child documents which is used when rendering.
OptionalgroupsAll children grouped by their kind.
OptionalpackageThe name of the package that this reflection documents according to package.json.
OptionalpackageThe version of the package that this reflection documents according to package.json.
OptionalparentThe reflection this reflection is a child of.
OptionalreadmeThe contents of the readme.md file of the project when found.
A reflection that represents the root of the project.
The project reflection acts as a global index, one may receive all reflections and source files of the processed project through this reflection.