typedoc 0.26.1 → 0.26.3

package/dist/lib/internationalization/locales/zh.d.cts

@@ -1,321 +1,2 @@
-declare const _default: {
-    loaded_multiple_times_0: "TypeDoc 已加载多次。这通常是由具有自己的 TypeDoc 安装的插件引起的。加载的路径为：\n{0}";
-    unsupported_ts_version_0: "您正在使用不受支持的 TypeScript 版本运行！如果 TypeDoc 崩溃，这就是原因。TypeDoc 支持 {0}";
-    no_compiler_options_set: string;
-    loaded_plugin_0: "已加载插件 {0}";
-    solution_not_supported_in_watch_mode: string;
-    strategy_not_supported_in_watch_mode: string;
-    found_0_errors_and_1_warnings: "发现 {0} 个错误和 {1} 个警告";
-    docs_could_not_be_generated: string;
-    docs_generated_at_0: "文档生成于 {0}";
-    json_written_to_0: "JSON 已写入 {0}";
-    no_entry_points_for_packages: string;
-    failed_to_find_packages: string;
-    nested_packages_unsupported_0: "位于 {0} 的项目已将 entryPointStrategy 设置为包，但不支持嵌套包";
-    previous_error_occurred_when_reading_options_for_0: "读取 {0} 处的包的选项时发生上一个错误";
-    converting_project_at_0: "正在转换 {0} 处的项目";
-    failed_to_convert_packages: string;
-    merging_converted_projects: string;
-    no_entry_points_to_merge: string;
-    entrypoint_did_not_match_files_0: "入口点 glob {0} 与任何文件均不匹配";
-    failed_to_parse_json_0: "无法将 {0} 处的文件解析为 json";
-    failed_to_read_0_when_processing_document_tag_in_1: "处理 {1} 中注释的 @document 标记时无法读取文件 {0}";
-    failed_to_read_0_when_processing_project_document: "添加项目文档时无法读取文件 {0}";
-    failed_to_read_0_when_processing_document_child_in_1: "处理 {1} 中的文档子项时无法读取文件 {0}";
-    frontmatter_children_0_should_be_an_array_of_strings_or_object_with_string_values: "{0} 中的 Frontmatter 子项应为字符串数组或具有字符串值的对象";
-    converting_union_as_interface: string;
-    converting_0_as_class_requires_value_declaration: "将 {0} 转换为类需要表示非类型值的声明";
-    converting_0_as_class_without_construct_signatures: "{0} 正在转换为类，但没有任何构造签名";
-    comment_for_0_should_not_contain_block_or_modifier_tags: "{0} 的注释不应包含任何块或修饰符标签";
-    symbol_0_has_multiple_declarations_with_comment: "{0} 有多个带注释的声明。将使用任意注释";
-    comments_for_0_are_declared_at_1: "{0} 的注释声明于：\n{1}";
-    multiple_type_parameters_on_template_tag_unsupported: string;
-    failed_to_find_jsdoc_tag_for_name_0: "解析注释后无法找到 {0} 的 JSDoc 标签，请提交错误报告";
-    relative_path_0_does_not_exist: "相对路径 {0} 不存在";
-    inline_inheritdoc_should_not_appear_in_block_tag_in_comment_at_0: "内联 @inheritDoc 标记不应出现在块标记内，因为它不会在 {0} 处的注释中被处理。";
-    at_most_one_remarks_tag_expected_in_comment_at_0: "注释中最多应有一个 @remarks 标签，忽略 {0} 处注释中除第一个标签之外的所有标签";
-    at_most_one_returns_tag_expected_in_comment_at_0: "注释中最多应有一个 @returns 标签，忽略 {0} 处注释中除第一个标签之外的所有标签";
-    at_most_one_inheritdoc_tag_expected_in_comment_at_0: "注释中最多应有一个 @inheritDoc 标签，忽略 {0} 处注释中除第一个标签之外的所有标签";
-    content_in_summary_overwritten_by_inheritdoc_in_comment_at_0: "摘要部分的内容将被 {0} 处注释中的 @inheritDoc 标记覆盖";
-    content_in_remarks_block_overwritten_by_inheritdoc_in_comment_at_0: "@remarks 块中的内容将被 {0} 处注释中的 @inheritDoc 标记覆盖";
-    example_tag_literal_name: string;
-    inheritdoc_tag_properly_capitalized: string;
-    treating_unrecognized_tag_0_as_modifier: "将无法识别的标签 {0} 视为修饰标签";
-    unmatched_closing_brace: string;
-    unescaped_open_brace_without_inline_tag: string;
-    unknown_block_tag_0: "遇到未知的区块标记 {0}";
-    unknown_inline_tag_0: "遇到未知的内联标记 {0}";
-    open_brace_within_inline_tag: string;
-    inline_tag_not_closed: string;
-    failed_to_resolve_link_to_0_in_comment_for_1: "无法解析“{1}”评论中的“{0}”链接";
-    type_0_defined_in_1_is_referenced_by_2_but_not_included_in_docs: "{0} 在 {1} 中定义，被 {2} 引用，但未包含在文档中";
-    reflection_0_kind_1_defined_in_2_does_not_have_any_documentation: "{0} ({1})，在 {2} 中定义，没有任何文档";
-    invalid_intentionally_not_exported_symbols_0: "以下符号被标记为有意不导出，但未在文档中引用，或已被导出：\n{0}";
-    not_all_search_category_boosts_used_0: "文档中并未使用 searchCategoryBoosts 中指定的所有类别。未使用的类别包括：\n{0}";
-    not_all_search_group_boosts_used_0: "文档中并未使用 searchGroupBoosts 中指定的所有组。未使用的组为：\n{0}";
-    comment_for_0_includes_categoryDescription_for_1_but_no_child_in_group: "{0} 的评论包含“{1}”的 @categoryDe​​scription，但该类别中没有子项";
-    comment_for_0_includes_groupDescription_for_1_but_no_child_in_group: "对 {0} 的评论包含“{1}”的 @groupDescription，但该组中没有子项";
-    label_0_for_1_cannot_be_referenced: "无法使用声明引用来引用 {1} 的标签“{0}”。标签只能包含 A-Z、0-9 和 _，并且不能以数字开头";
-    modifier_tag_0_is_mutually_exclusive_with_1_in_comment_for_2: "修饰符标记 {0} 与 {2} 注释中的 {1} 互斥";
-    signature_0_has_unused_param_with_name_1: "签名 {0} 有一个名为“{1}”的 @param，但未被使用";
-    declaration_reference_in_inheritdoc_for_0_not_fully_parsed: "@inheritDoc 中对 {0} 的声明引用未完全解析，可能会解析不正确";
-    failed_to_find_0_to_inherit_comment_from_in_1: "在 {1} 的评论中找不到要继承的评论“{0}”";
-    failed_to_resolve_link_to_0_in_comment_for_1_may_have_meant_2: "无法解析 {1} 的注释中指向\"{0}\"的链接。您可能想要\"{2}\"";
-    failed_to_resolve_link_to_0_in_readme_for_1: "无法解析 {1} 的自述文件中指向\"{0}\"的链接";
-    failed_to_resolve_link_to_0_in_readme_for_1_may_have_meant_2: "无法解析 {1} 的自述文件中指向\"{0}\"的链接。您可能想要\"{2}\"";
-    reflection_0_tried_to_copy_comment_from_1_but_source_had_no_comment: "{0} 尝试使用 @inheritDoc 从 {1} 复制注释，但源没有相关注释";
-    inheritdoc_circular_inheritance_chain_0: "@inheritDoc 指定循环继承链：{0}";
-    provided_readme_at_0_could_not_be_read: "提供的 README 路径无法读取 {0}";
-    defaulting_project_name: string;
-    disable_git_set_but_not_source_link_template: string;
-    disable_git_set_and_git_revision_used: string;
-    git_remote_0_not_valid: "提供的 git 远程“{0}”无效。源链接将失效";
-    custom_css_file_0_does_not_exist: "{0} 处的自定义 CSS 文件不存在";
-    unsupported_highlight_language_0_not_highlighted_in_comment_for_1: "不支持的突出显示语言 {0} 将不会在 {1} 的评论中突出显示";
-    unloaded_language_0_not_highlighted_in_comment_for_1: "语言为 {0} 的代码块将不会在 {1} 的注释中突出显示，因为它未包含在 highlightLanguages 选项中";
-    yaml_frontmatter_not_an_object: string;
-    could_not_write_0: "无法写入 {0}";
-    could_not_empty_output_directory_0: "无法清空输出目录 {0}";
-    could_not_create_output_directory_0: "无法创建输出目录 {0}";
-    theme_0_is_not_defined_available_are_1: "主题“{0}”未定义。可用主题为：{1}";
-    custom_theme_does_not_define_getSlugger: string;
-    no_entry_points_provided: string;
-    unable_to_find_any_entry_points: string;
-    watch_does_not_support_packages_mode: string;
-    watch_does_not_support_merge_mode: string;
-    entry_point_0_not_in_program: "入口点 {0} 未被 tsconfig 中的“files”或“include”选项引用";
-    use_expand_or_glob_for_files_in_dir: string;
-    glob_0_did_not_match_any_files: "glob {0} 与任何文件均不匹配";
-    entry_point_0_did_not_match_any_files_after_exclude: "应用排除模式后，glob {0} 没有匹配任何文件";
-    entry_point_0_did_not_exist: "提供的入口点 {0} 不存在";
-    entry_point_0_did_not_match_any_packages: "入口点 glob {0} 与任何包含 package.json 的目录不匹配";
-    file_0_not_an_object: "文件 {0} 不是对象";
-    serialized_project_referenced_0_not_part_of_project: "序列化项目引用了反射 {0}，但它不是项目的一部分";
-    saved_relative_path_0_resolved_from_1_does_not_exist: "序列化项目引用了 {0}，相对于 {1} 而言，它并不存在";
-    circular_reference_extends_0: "{0} 的“extends”字段出现循环引用";
-    failed_resolve_0_to_file_in_1: "无法将 {0} 解析为 {1} 中的文件";
-    option_0_can_only_be_specified_by_config_file: "“{0}”选项只能通过配置文件指定";
-    option_0_expected_a_value_but_none_provided: "--{0} 需要一个值，但没有给出任何参数";
-    unknown_option_0_may_have_meant_1: "未知选项：{0}，你可能指的是：\n{1}";
-    typedoc_key_in_0_ignored: "{0} 中的“typedoc”键已被旧包 entryPointStrategy 使用，将被忽略";
-    typedoc_options_must_be_object_in_0: "无法解析 {0} 中的“typedocOptions”字段，请确保它存在且包含对象";
-    tsconfig_file_0_does_not_exist: "tsconfig 文件 {0} 不存在";
-    tsconfig_file_specifies_options_file: string;
-    tsconfig_file_specifies_tsconfig_file: string;
-    tags_0_defined_in_typedoc_json_overwritten_by_tsdoc_json: "typedoc.json 中定义的 {0} 将被 tsdoc.json 中的配置覆盖";
-    failed_read_tsdoc_json_0: "无法读取位于 {0} 的 tsdoc.json 文件";
-    invalid_tsdoc_json_0: "文件 {0} 不是有效的 tsdoc.json 文件";
-    options_file_0_does_not_exist: "选项文件 {0} 不存在";
-    failed_read_options_file_0: "无法解析 {0}，请确保其存在并导出对象";
-    invalid_plugin_0_missing_load_function: "插件 {0} 中的结构无效，未找到加载函数";
-    plugin_0_could_not_be_loaded: "无法加载插件 {0}";
-    help_options: string;
-    help_tsconfig: string;
-    help_compilerOptions: string;
-    help_lang: string;
-    help_locales: string;
-    help_packageOptions: string;
-    help_entryPoints: string;
-    help_entryPointStrategy: string;
-    help_alwaysCreateEntryPointModule: string;
-    help_projectDocuments: string;
-    help_exclude: string;
-    help_externalPattern: string;
-    help_excludeExternals: string;
-    help_excludeNotDocumented: string;
-    help_excludeNotDocumentedKinds: string;
-    help_excludeInternal: string;
-    help_excludeCategories: string;
-    help_excludePrivate: string;
-    help_excludeProtected: string;
-    help_excludeReferences: string;
-    help_externalSymbolLinkMappings: string;
-    help_out: string;
-    help_json: string;
-    help_pretty: string;
-    help_emit: string;
-    help_theme: string;
-    help_lightHighlightTheme: string;
-    help_darkHighlightTheme: string;
-    help_highlightLanguages: string;
-    help_customCss: string;
-    help_markdownItOptions: string;
-    help_markdownItLoader: string;
-    help_maxTypeConversionDepth: string;
-    help_name: string;
-    help_includeVersion: string;
-    help_disableSources: string;
-    help_sourceLinkTemplate: string;
-    help_gitRevision: string;
-    help_gitRemote: string;
-    help_disableGit: string;
-    help_basePath: string;
-    help_excludeTags: string;
-    help_readme: string;
-    help_cname: string;
-    help_sourceLinkExternal: string;
-    help_githubPages: string;
-    help_hostedBaseUrl: string;
-    help_useHostedBaseUrlForAbsoluteLinks: string;
-    help_hideGenerator: string;
-    help_customFooterHtml: string;
-    help_customFooterHtmlDisableWrapper: string;
-    help_hideParameterTypesInTitle: string;
-    help_cacheBust: string;
-    help_searchInComments: string;
-    help_searchInDocuments: string;
-    help_cleanOutputDir: string;
-    help_titleLink: string;
-    help_navigationLinks: string;
-    help_sidebarLinks: string;
-    help_navigationLeaves: string;
-    help_navigation: string;
-    help_visibilityFilters: string;
-    help_searchCategoryBoosts: string;
-    help_searchGroupBoosts: string;
-    help_jsDocCompatibility: string;
-    help_commentStyle: string;
-    help_useTsLinkResolution: string;
-    help_preserveLinkText: string;
-    help_blockTags: string;
-    help_inlineTags: string;
-    help_modifierTags: string;
-    help_categorizeByGroup: string;
-    help_defaultCategory: string;
-    help_categoryOrder: string;
-    help_groupOrder: string;
-    help_sort: string;
-    help_sortEntryPoints: string;
-    help_kindSortOrder: string;
-    help_watch: string;
-    help_preserveWatchOutput: string;
-    help_skipErrorChecking: string;
-    help_help: string;
-    help_version: string;
-    help_showConfig: string;
-    help_plugin: string;
-    help_logLevel: string;
-    help_treatWarningsAsErrors: string;
-    help_treatValidationWarningsAsErrors: string;
-    help_intentionallyNotExported: string;
-    help_requiredToBeDocumented: string;
-    help_validation: string;
-    unknown_option_0_you_may_have_meant_1: "未知选项“{0}” 你可能指的是：\n{1}";
-    option_0_must_be_between_1_and_2: "{0} 必须介于 {1} 和 {2} 之间";
-    option_0_must_be_equal_to_or_greater_than_1: "{0} 必须等于或大于 {1}";
-    option_0_must_be_less_than_or_equal_to_1: "{0} 必须小于或等于 {1}";
-    option_0_must_be_one_of_1: "{0} 必须是 {1} 之一";
-    flag_0_is_not_valid_for_1_expected_2: "标志“{0}”对 {1} 无效，应为 {2} 之一";
-    expected_object_with_flag_values_for_0: "预期为一个带有标志值为 {0} 或 true/false 的对象";
-    flag_values_for_0_must_be_booleans: "{0} 的标志值必须是布尔值";
-    locales_must_be_an_object: string;
-    exclude_not_documented_specified_0_valid_values_are_1: "excludeNotDocumentedKinds 只能指定已知值，并且提供了无效值 ({0})。有效类型为：\n{1}";
-    external_symbol_link_mappings_must_be_object: string;
-    highlight_theme_0_must_be_one_of_1: "{0} 必须是下列之一：{1}";
-    highlightLanguages_contains_invalid_languages_0: "highlightLanguages 包含无效语言：{0}，运行 typedoc --help 获取受支持语言的列表";
-    hostedBaseUrl_must_start_with_http: string;
-    useHostedBaseUrlForAbsoluteLinks_requires_hostedBaseUrl: string;
-    option_0_must_be_an_object: "“{0}”选项必须是非数组对象";
-    option_0_must_be_a_function: "‘{0}’ 选项必须是一个函数";
-    option_0_must_be_object_with_urls: "{0} 必须是具有字符串标签作为键和 URL 值的对象";
-    visibility_filters_only_include_0: "visibilityFilters 只能包含以下非@键：{0}";
-    visibility_filters_must_be_booleans: string;
-    option_0_values_must_be_numbers: "{0} 的所有值都必须是数字";
-    option_0_values_must_be_array_of_tags: "{0} 必须是有效标签名称的数组";
-    option_0_specified_1_but_only_2_is_valid: "{0} 只能指定已知值，并且提供了无效值 ({1})。有效的排序策略为：\n{2}";
-    kind_project: string;
-    kind_module: string;
-    kind_namespace: string;
-    kind_enum: string;
-    kind_enum_member: string;
-    kind_variable: string;
-    kind_function: string;
-    kind_class: string;
-    kind_interface: string;
-    kind_constructor: string;
-    kind_property: string;
-    kind_method: string;
-    kind_call_signature: string;
-    kind_index_signature: string;
-    kind_constructor_signature: string;
-    kind_parameter: string;
-    kind_type_literal: string;
-    kind_type_parameter: string;
-    kind_accessor: string;
-    kind_get_signature: string;
-    kind_set_signature: string;
-    kind_type_alias: string;
-    kind_reference: string;
-    kind_document: string;
-    kind_plural_project: string;
-    kind_plural_module: string;
-    kind_plural_namespace: string;
-    kind_plural_enum: string;
-    kind_plural_enum_member: string;
-    kind_plural_variable: string;
-    kind_plural_function: string;
-    kind_plural_class: string;
-    kind_plural_interface: string;
-    kind_plural_constructor: string;
-    kind_plural_property: string;
-    kind_plural_method: string;
-    kind_plural_call_signature: string;
-    kind_plural_index_signature: string;
-    kind_plural_constructor_signature: string;
-    kind_plural_parameter: string;
-    kind_plural_type_literal: string;
-    kind_plural_type_parameter: string;
-    kind_plural_accessor: string;
-    kind_plural_get_signature: string;
-    kind_plural_set_signature: string;
-    kind_plural_type_alias: string;
-    kind_plural_reference: string;
-    kind_plural_document: string;
-    flag_protected: string;
-    flag_private: string;
-    flag_external: string;
-    flag_inherited: string;
-    flag_public: string;
-    flag_static: string;
-    flag_optional: string;
-    flag_rest: string;
-    flag_abstract: string;
-    flag_const: string;
-    flag_readonly: string;
-    theme_implements: string;
-    theme_indexable: string;
-    theme_type_declaration: string;
-    theme_index: string;
-    theme_hierarchy: string;
-    theme_hierarchy_view_full: string;
-    theme_implemented_by: string;
-    theme_defined_in: string;
-    theme_implementation_of: string;
-    theme_inherited_from: string;
-    theme_overrides: string;
-    theme_returns: string;
-    theme_re_exports: string;
-    theme_renames_and_re_exports: string;
-    theme_generated_using_typedoc: string;
-    theme_preparing_search_index: string;
-    theme_search_index_not_available: string;
-    theme_settings: string;
-    theme_member_visibility: string;
-    theme_theme: string;
-    theme_os: string;
-    theme_light: string;
-    theme_dark: string;
-    theme_on_this_page: string;
-    theme_search: string;
-    theme_menu: string;
-    theme_permalink: string;
-    tag_see: string;
-    tag_group: string;
-    tag_example: string;
-    theme_copy: string;
-    theme_copied: string;
-    theme_normally_hidden: string;
-    theme_class_hierarchy_title: string;
-    theme_loading: string;
-};
+declare const _default: Partial<import("../translatable").BuiltinTranslatableStringConstraints>;
 export = _default;

package/dist/lib/internationalization/translatable.d.ts

@@ -1,6 +1,6 @@
 import type { blockTags, inlineTags, modifierTags } from "../utils/options/tsdoc-defaults";
-export declare function buildTranslation<T extends BuiltinTranslatableStringConstraints>(translations: T): T;
-export declare function buildIncompleteTranslation<T extends Partial<BuiltinTranslatableStringConstraints>>(translations: T): T;
+export declare function buildTranslation(translations: BuiltinTranslatableStringConstraints): BuiltinTranslatableStringConstraints;
+export declare function buildIncompleteTranslation(translations: Partial<BuiltinTranslatableStringConstraints>): Partial<BuiltinTranslatableStringConstraints>;
 export declare const translatable: {
     readonly loaded_multiple_times_0: "TypeDoc has been loaded multiple times. This is commonly caused by plugins which have their own installation of TypeDoc. The loaded paths are:\n\t{0}";
     readonly unsupported_ts_version_0: "You are running with an unsupported TypeScript version! If TypeDoc crashes, this is why. TypeDoc supports {0}";
@@ -34,7 +34,7 @@ export declare const translatable: {
     readonly comments_for_0_are_declared_at_1: "The comments for {0} are declared at:\n\t{1}";
     readonly multiple_type_parameters_on_template_tag_unsupported: "TypeDoc does not support multiple type parameters defined in a single @template tag with a comment";
     readonly failed_to_find_jsdoc_tag_for_name_0: "Failed to find JSDoc tag for {0} after parsing comment, please file a bug report";
-    readonly relative_path_0_does_not_exist: "The relative path {0} does not exist";
+    readonly relative_path_0_is_not_a_file_and_will_not_be_copied_to_output: "The relative path {0} is not a file and will not be copied to the output directory";
     readonly inline_inheritdoc_should_not_appear_in_block_tag_in_comment_at_0: "An inline @inheritDoc tag should not appear within a block tag as it will not be processed in comment at {0}";
     readonly at_most_one_remarks_tag_expected_in_comment_at_0: "At most one @remarks tag is expected in a comment, ignoring all but the first in comment at {0}";
     readonly at_most_one_returns_tag_expected_in_comment_at_0: "At most one @returns tag is expected in a comment, ignoring all but the first in comment at {0}";
@@ -94,7 +94,7 @@ export declare const translatable: {
     readonly entry_point_0_did_not_match_any_packages: "The entry point glob {0} did not match any directories containing package.json";
     readonly file_0_not_an_object: "The file {0} is not an object";
     readonly serialized_project_referenced_0_not_part_of_project: "Serialized project referenced reflection {0}, which was not a part of the project";
-    readonly saved_relative_path_0_resolved_from_1_does_not_exist: "Serialized project referenced {0}, which does not exist relative to {1}";
+    readonly saved_relative_path_0_resolved_from_1_is_not_a_file: "Serialized project referenced {0}, which does not exist or is not a file relative to {1}";
     readonly circular_reference_extends_0: "Circular reference encountered for \"extends\" field of {0}";
     readonly failed_resolve_0_to_file_in_1: "Failed to resolve {0} to a file in {1}";
     readonly option_0_can_only_be_specified_by_config_file: "The '{0}' option can only be specified via a config file";

package/dist/lib/internationalization/translatable.js

@@ -43,7 +43,7 @@ exports.translatable = {
     // comments/parser.ts
     multiple_type_parameters_on_template_tag_unsupported: `TypeDoc does not support multiple type parameters defined in a single @template tag with a comment`,
     failed_to_find_jsdoc_tag_for_name_0: `Failed to find JSDoc tag for {0} after parsing comment, please file a bug report`,
-    relative_path_0_does_not_exist: `The relative path {0} does not exist`,
+    relative_path_0_is_not_a_file_and_will_not_be_copied_to_output: `The relative path {0} is not a file and will not be copied to the output directory`,
     inline_inheritdoc_should_not_appear_in_block_tag_in_comment_at_0: "An inline @inheritDoc tag should not appear within a block tag as it will not be processed in comment at {0}",
     at_most_one_remarks_tag_expected_in_comment_at_0: "At most one @remarks tag is expected in a comment, ignoring all but the first in comment at {0}",
     at_most_one_returns_tag_expected_in_comment_at_0: "At most one @returns tag is expected in a comment, ignoring all but the first in comment at {0}",
@@ -109,7 +109,7 @@ exports.translatable = {
     file_0_not_an_object: `The file {0} is not an object`,
     // deserialization
     serialized_project_referenced_0_not_part_of_project: `Serialized project referenced reflection {0}, which was not a part of the project`,
-    saved_relative_path_0_resolved_from_1_does_not_exist: `Serialized project referenced {0}, which does not exist relative to {1}`,
+    saved_relative_path_0_resolved_from_1_is_not_a_file: `Serialized project referenced {0}, which does not exist or is not a file relative to {1}`,
     // options
     circular_reference_extends_0: `Circular reference encountered for "extends" field of {0}`,
     failed_resolve_0_to_file_in_1: `Failed to resolve {0} to a file in {1}`,

package/dist/lib/models/FileRegistry.js

@@ -3,7 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.ValidatingFileRegistry = exports.FileRegistry = void 0;
 const path_1 = require("path");
 const utils_1 = require("../utils");
-const fs_1 = require("fs");
 class FileRegistry {
     constructor() {
         this.nextId = 1;
@@ -111,7 +110,7 @@ exports.FileRegistry = FileRegistry;
 class ValidatingFileRegistry extends FileRegistry {
     register(sourcePath, relativePath) {
         const absolute = (0, path_1.resolve)((0, path_1.dirname)(sourcePath), relativePath);
-        if (!(0, fs_1.existsSync)(absolute)) {
+        if (!(0, utils_1.isFile)(absolute)) {
             return;
         }
         return this.registerAbsolute(absolute);
@@ -119,8 +118,8 @@ class ValidatingFileRegistry extends FileRegistry {
     fromObject(de, obj) {
         for (const [key, val] of Object.entries(obj.entries)) {
             const absolute = (0, utils_1.normalizePath)((0, path_1.resolve)(de.projectRoot, val));
-            if (!(0, fs_1.existsSync)(absolute)) {
-                de.logger.warn(de.logger.i18n.saved_relative_path_0_resolved_from_1_does_not_exist(val, de.projectRoot));
+            if (!(0, utils_1.isFile)(absolute)) {
+                de.logger.warn(de.logger.i18n.saved_relative_path_0_resolved_from_1_is_not_a_file(val, de.projectRoot));
                 continue;
             }
             de.oldFileIdToNewFileId[+key] = this.registerAbsolute(absolute);

package/dist/lib/models/comments/comment.d.ts

@@ -180,6 +180,13 @@ export declare class Comment {
      * @internal
      */
     discoveryId?: number;
+    /**
+     * If the comment was inherited from a different "parent" declaration
+     * (see #2545), then it is desirable to know this as any `@param` tags
+     * which do not apply should not cause warnings. This is not serialized,
+     * and only set when the comment was created from a `ts.CommentRange`.
+     */
+    inheritedFromParentDeclaration?: boolean;
     /**
      * Creates a new Comment instance.
      */

package/dist/lib/models/comments/comment.js

@@ -94,6 +94,9 @@ let Comment = (() => {
     let _discoveryId_decorators;
     let _discoveryId_initializers = [];
     let _discoveryId_extraInitializers = [];
+    let _inheritedFromParentDeclaration_decorators;
+    let _inheritedFromParentDeclaration_initializers = [];
+    let _inheritedFromParentDeclaration_extraInitializers = [];
     return _a = class Comment {
             /**
              * Debugging utility for combining parts into a simple string. Not suitable for
@@ -301,7 +304,14 @@ let Comment = (() => {
                  * @internal
                  */
                 this.discoveryId = (__runInitializers(this, _sourcePath_extraInitializers), __runInitializers(this, _discoveryId_initializers, void 0));
-                __runInitializers(this, _discoveryId_extraInitializers);
+                /**
+                 * If the comment was inherited from a different "parent" declaration
+                 * (see #2545), then it is desirable to know this as any `@param` tags
+                 * which do not apply should not cause warnings. This is not serialized,
+                 * and only set when the comment was created from a `ts.CommentRange`.
+                 */
+                this.inheritedFromParentDeclaration = (__runInitializers(this, _discoveryId_extraInitializers), __runInitializers(this, _inheritedFromParentDeclaration_initializers, void 0));
+                __runInitializers(this, _inheritedFromParentDeclaration_extraInitializers);
                 this.summary = summary;
                 this.blockTags = blockTags;
                 this.modifierTags = modifierTags;
@@ -314,6 +324,8 @@ let Comment = (() => {
                 const comment = new _a(_a.cloneDisplayParts(this.summary), this.blockTags.map((tag) => tag.clone()), new Set(this.modifierTags));
                 comment.discoveryId = this.discoveryId;
                 comment.sourcePath = this.sourcePath;
+                comment.inheritedFromParentDeclaration =
+                    this.inheritedFromParentDeclaration;
                 return comment;
             }
             /**
@@ -395,8 +407,10 @@ let Comment = (() => {
             const _metadata = typeof Symbol === "function" && Symbol.metadata ? Object.create(null) : void 0;
             _sourcePath_decorators = [general_1.NonEnumerable];
             _discoveryId_decorators = [general_1.NonEnumerable];
+            _inheritedFromParentDeclaration_decorators = [general_1.NonEnumerable];
             __esDecorate(null, null, _sourcePath_decorators, { kind: "field", name: "sourcePath", static: false, private: false, access: { has: obj => "sourcePath" in obj, get: obj => obj.sourcePath, set: (obj, value) => { obj.sourcePath = value; } }, metadata: _metadata }, _sourcePath_initializers, _sourcePath_extraInitializers);
             __esDecorate(null, null, _discoveryId_decorators, { kind: "field", name: "discoveryId", static: false, private: false, access: { has: obj => "discoveryId" in obj, get: obj => obj.discoveryId, set: (obj, value) => { obj.discoveryId = value; } }, metadata: _metadata }, _discoveryId_initializers, _discoveryId_extraInitializers);
+            __esDecorate(null, null, _inheritedFromParentDeclaration_decorators, { kind: "field", name: "inheritedFromParentDeclaration", static: false, private: false, access: { has: obj => "inheritedFromParentDeclaration" in obj, get: obj => obj.inheritedFromParentDeclaration, set: (obj, value) => { obj.inheritedFromParentDeclaration = value; } }, metadata: _metadata }, _inheritedFromParentDeclaration_initializers, _inheritedFromParentDeclaration_extraInitializers);
             if (_metadata) Object.defineProperty(_a, Symbol.metadata, { enumerable: true, configurable: true, writable: true, value: _metadata });
         })(),
         _a;

package/dist/lib/output/events.d.ts

@@ -43,6 +43,13 @@ export declare class RendererEvent {
      */
     createPageEvent<Model>(mapping: UrlMapping<Model>): [RenderTemplate<PageEvent<Model>>, PageEvent<Model>];
 }
+export interface PageHeading {
+    link: string;
+    text: string;
+    level?: number;
+    kind?: ReflectionKind;
+    classes?: string;
+}
 /**
  * An event emitted by the {@link Renderer} class before and after the
  * markup of a page is rendered.
@@ -77,13 +84,19 @@ export declare class PageEvent<out Model = unknown> extends Event {
      * Links to content within this page that should be rendered in the page navigation.
      * This is built when rendering the document content.
      */
-    pageHeadings: Array<{
-        link: string;
-        text: string;
-        level?: number;
-        kind?: ReflectionKind;
-        classes?: string;
-    }>;
+    pageHeadings: PageHeading[];
+    /**
+     * Sections of the page, generally set by `@group`s
+     */
+    pageSections: {
+        title: string;
+        headings: PageHeading[];
+    }[];
+    /**
+     * Start a new section of the page. Sections are collapsible within
+     * the "On This Page" sidebar.
+     */
+    startNewSection(title: string): void;
     /**
      * Triggered before a document will be rendered.
      * @event

package/dist/lib/output/events.js

@@ -71,6 +71,17 @@ RendererEvent.END = "endRender";
  * @see {@link Renderer.EVENT_END_PAGE}
  */
 class PageEvent extends Event {
+    /**
+     * Start a new section of the page. Sections are collapsible within
+     * the "On This Page" sidebar.
+     */
+    startNewSection(title) {
+        this.pageHeadings = [];
+        this.pageSections.push({
+            title,
+            headings: this.pageHeadings,
+        });
+    }
     constructor(name, model) {
         super(name);
         /**
@@ -78,6 +89,15 @@ class PageEvent extends Event {
          * This is built when rendering the document content.
          */
         this.pageHeadings = [];
+        /**
+         * Sections of the page, generally set by `@group`s
+         */
+        this.pageSections = [
+            {
+                title: "",
+                headings: this.pageHeadings,
+            },
+        ];
         this.model = model;
     }
 }

package/dist/lib/output/themes/default/DefaultThemeRenderContext.d.ts

@@ -5,7 +5,7 @@ import { type NeverIfInternal, type Options } from "../../../utils";
 import type { DefaultTheme } from "./DefaultTheme";
 import { type icons } from "./partials/icon";
 export declare class DefaultThemeRenderContext {
-    private theme;
+    readonly theme: DefaultTheme;
     page: PageEvent<Reflection>;
     private _refIcons;
     options: Options;
@@ -63,7 +63,8 @@ export declare class DefaultThemeRenderContext {
     memberSignatures: (props: DeclarationReflection) => import("../../../utils/jsx.elements").JsxElement;
     memberSources: (props: DeclarationReflection | import("../../../models").SignatureReflection) => import("../../../utils/jsx.elements").JsxElement;
     members: (props: import("../../../models").ContainerReflection) => import("../../../utils/jsx.elements").JsxElement;
-    membersGroup: (group: import("../../../models").ReflectionGroup) => import("../../../utils/jsx.elements").JsxElement;
+    /** @deprecated Since 0.26.3 members does group/category flattening internally */
+    membersGroup?: Function;
     sidebar: (props: PageEvent<Reflection>) => import("../../../utils/jsx.elements").JsxElement;
     pageSidebar: (props: PageEvent<Reflection>) => import("../../../utils/jsx.elements").JsxElement;
     sidebarLinks: () => import("../../../utils/jsx.elements").JsxElement | null;

package/dist/lib/output/themes/default/DefaultThemeRenderContext.js

@@ -18,7 +18,6 @@ const member_signature_title_1 = require("./partials/member.signature.title");
 const member_signatures_1 = require("./partials/member.signatures");
 const member_sources_1 = require("./partials/member.sources");
 const members_1 = require("./partials/members");
-const members_group_1 = require("./partials/members.group");
 const navigation_1 = require("./partials/navigation");
 const parameter_1 = require("./partials/parameter");
 const reflectionPreview_1 = require("./partials/reflectionPreview");
@@ -87,7 +86,6 @@ class DefaultThemeRenderContext {
         this.memberSignatures = bind(member_signatures_1.memberSignatures, this);
         this.memberSources = bind(member_sources_1.memberSources, this);
         this.members = bind(members_1.members, this);
-        this.membersGroup = bind(members_group_1.membersGroup, this);
         this.sidebar = bind(navigation_1.sidebar, this);
         this.pageSidebar = bind(navigation_1.pageSidebar, this);
         this.sidebarLinks = bind(navigation_1.sidebarLinks, this);

package/dist/lib/output/themes/default/partials/members.d.ts

@@ -1,4 +1,4 @@
 import type { DefaultThemeRenderContext } from "../DefaultThemeRenderContext";
 import { JSX } from "../../../../utils";
-import { type ContainerReflection } from "../../../../models";
+import type { ContainerReflection } from "../../../../models";
 export declare function members(context: DefaultThemeRenderContext, props: ContainerReflection): JSX.Element;

package/dist/lib/output/themes/default/partials/members.js

@@ -2,17 +2,47 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.members = members;
 const utils_1 = require("../../../../utils");
-const models_1 = require("../../../../models");
-const lib_1 = require("../../lib");
+function getMemberSections(parent) {
+    if (parent.categories?.length) {
+        return (0, utils_1.filterMap)(parent.categories, (cat) => {
+            if (!cat.allChildrenHaveOwnDocument()) {
+                return {
+                    title: cat.title,
+                    children: cat.children.filter((child) => !child.hasOwnDocument),
+                };
+            }
+        });
+    }
+    if (parent.groups?.length) {
+        return parent.groups.flatMap((group) => {
+            if (group.categories?.length) {
+                return (0, utils_1.filterMap)(group.categories, (cat) => {
+                    if (!cat.allChildrenHaveOwnDocument()) {
+                        return {
+                            title: `${group.title} - ${cat.title}`,
+                            children: cat.children.filter((child) => !child.hasOwnDocument),
+                        };
+                    }
+                });
+            }
+            return {
+                title: group.title,
+                children: group.children.filter((child) => !child.hasOwnDocument),
+            };
+        });
+    }
+    return [];
+}
 function members(context, props) {
-    if (props.categories && props.categories.length) {
-        return (utils_1.JSX.createElement(utils_1.JSX.Fragment, null, props.categories.map((item) => !item.allChildrenHaveOwnDocument() && (utils_1.JSX.createElement("details", { class: (0, lib_1.classNames)({ "tsd-panel-group": true, "tsd-member-group": true, "tsd-accordion": true }, props instanceof models_1.DeclarationReflection ? context.getReflectionClasses(props) : "") },
-            utils_1.JSX.createElement("summary", { class: "tsd-accordion-summary", "data-key": "section-" + item.title },
+    const sections = getMemberSections(props).filter((sect) => sect.children.length);
+    return (utils_1.JSX.createElement(utils_1.JSX.Fragment, null, sections.map(({ title, children }) => {
+        context.page.startNewSection(title);
+        return (utils_1.JSX.createElement("details", { class: "tsd-panel-group tsd-member-group tsd-accordion", open: true },
+            utils_1.JSX.createElement("summary", { class: "tsd-accordion-summary", "data-key": "section-" + title },
                 utils_1.JSX.createElement("h2", null,
                     context.icons.chevronDown(),
                     " ",
-                    item.title)),
-            utils_1.JSX.createElement("section", null, item.children.map((item) => !item.hasOwnDocument && context.member(item))))))));
-    }
-    return utils_1.JSX.createElement(utils_1.JSX.Fragment, null, props.groups?.map((item) => !item.allChildrenHaveOwnDocument() && context.membersGroup(item)));
+                    title)),
+            utils_1.JSX.createElement("section", null, children.map((item) => context.member(item)))));
+    })));
 }