typedoc 0.27.9 → 0.28.0-beta.1

package/dist/lib/internationalization/locales/zh.cjs

@@ -10,6 +10,8 @@ module.exports = localeUtils.buildIncompleteTranslation({
     loaded_plugin_0: "已加载插件 {0}",
     solution_not_supported_in_watch_mode: "提供的 tsconfig 文件看起来像解决方案样式的 tsconfig，在监视模式下不受支持",
     strategy_not_supported_in_watch_mode: "对于监视模式，entryPointStrategy 必须设置为 resolve 或 expand",
+    file_0_changed_restarting: "配置文件 {0} 已更改：需要重新启动……",
+    file_0_changed_rebuilding: "文件 {0} 已更改：正在重新构建输出……",
     found_0_errors_and_1_warnings: "发现 {0} 个错误和 {1} 个警告",
     output_0_could_not_be_generated: "由于以上错误无法生成 {0} 输出",
     output_0_generated_at_1: "已生成 {0} 输出，位于 {1}",
@@ -33,6 +35,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     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}",
+    // comments/parser.ts
     multiple_type_parameters_on_template_tag_unsupported: "TypeDoc 不支持在带有注释的单个 @template 标签中定义多个类型参数",
     failed_to_find_jsdoc_tag_for_name_0: "解析注释后无法找到 {0} 的 JSDoc 标签，请提交错误报告",
     relative_path_0_is_not_a_file_and_will_not_be_copied_to_output: "找不到相对路径 {0} 对应的文件，该文件不会被复制至输出目录",
@@ -51,6 +54,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     unknown_inline_tag_0: "遇到未知的内联标签 {0}",
     open_brace_within_inline_tag: "在内联标签中遇到左括号，这可能是一个错误",
     inline_tag_not_closed: "内联标签未关闭",
+    // validation
     failed_to_resolve_link_to_0_in_comment_for_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}” 的链接",
@@ -59,9 +63,11 @@ module.exports = localeUtils.buildIncompleteTranslation({
     failed_to_resolve_link_to_0_in_document_1_may_have_meant_2: "无法解析文档 {1} 中指向 “{0}” 的链接。您可能想要 “{2}”",
     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}",
+    invalid_intentionally_not_documented_names_0: "以下的限定反射名称被设定为刻意无文档说明，但它们要么未在文档中被引用，要么已有文档说明：\n\t{0}",
+    invalid_intentionally_not_exported_symbols_0: "以下符号被设定为刻意非导出，但它们要么未在文档中被引用，要么已为导出符号：\n{0}",
     reflection_0_has_unused_mergeModuleWith_tag: "{0} 中存在无法解析的 @mergeModuleWith 标签",
     reflection_0_links_to_1_with_text_2_but_resolved_to_3: "“{0}”中的链接“{2}”指向“{1}”，目标虽然存在但并没有直接的链接，因此将改为链接至“{3}”。",
+    // conversion plugins
     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}”的 @categoryDescription，但该类别中没有子项",
@@ -81,16 +87,30 @@ module.exports = localeUtils.buildIncompleteTranslation({
     reflection_0_tried_to_merge_into_child_1: "反射 {0} 尝试使用 @mergeModuleWith 合并到其子项之一：{1}",
     include_0_in_1_specified_2_resolved_to_3_does_not_exist: "{1} 的注释中 {0} 标签指定了包含 “{2}”，解析为 “{3}”，该文件并不存在或并非文件。",
     include_0_in_1_specified_2_circular_include_3: "{1} 的注释中 {0} 标签指定了包含 “{2}”，导致了循环包含：\n\t{3}",
+    include_0_tag_in_1_specified_2_file_3_region_4_region_not_found: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件找不到该区域。`,
+    include_0_tag_in_1_region_2_region_not_supported: `{1} 中的 标签 {0} 指定了 “{2}”，但尚不支持对应的文件扩展名。`,
+    include_0_tag_in_1_specified_2_file_3_region_4_region_close_not_found: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中找不到该区域的结束注释。`,
+    include_0_tag_in_1_specified_2_file_3_region_4_region_open_not_found: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中找不到该区域的起始注释。`,
+    include_0_tag_in_1_specified_2_file_3_region_4_region_close_found_multiple_times: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域的结束注释出现了多次。`,
+    include_0_tag_in_1_specified_2_file_3_region_4_region_open_found_multiple_times: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域的起始注释出现了多次。`,
+    include_0_tag_in_1_specified_2_file_3_region_4_region_found_multiple_times: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域出现了多次。`,
+    include_0_tag_in_1_specified_2_file_3_region_4_region_empty: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域不包含内容或仅包含空白字符。`,
+    include_0_tag_in_1_specified_2_file_3_lines_4_invalid_range: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中的 {4} 行，但指定的行范围无效。`,
+    include_0_tag_in_1_specified_2_file_3_lines_4_but_only_5_lines: `{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中的 {4} 行，但该文件只有 {5} 行。`,
+    // output plugins
     custom_css_file_0_does_not_exist: "{0} 处的自定义 CSS 文件不存在",
     custom_js_file_0_does_not_exist: "{0} 处的自定义 JavaScript 文件不存在",
     unsupported_highlight_language_0_not_highlighted_in_comment_for_1: "{1} 的注释中使用了不支持的高亮语言 {0} ，因此该语言将不会被高亮",
     unloaded_language_0_not_highlighted_in_comment_for_1: "{1} 的注释中语言为 {0} 的代码块将不会被高亮，因为该语言未包含在 highlightLanguages 选项中",
     yaml_frontmatter_not_an_object: "YAML Frontmatter 应当为对象",
+    // renderer
     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}",
+    router_0_is_not_defined_available_are_1: `路由 “{0}” 未定义。可用的路由为：{1}`,
     reflection_0_links_to_1_but_anchor_does_not_exist_try_2: "{0} 链接至 {1}，但对应锚点不存在。你是否是指：\n\t{2}",
+    // entry points
     no_entry_points_provided: "没有提供入口点，这可能是配置错误",
     unable_to_find_any_entry_points: "无法找到任何入口点。请参阅先前的警告",
     watch_does_not_support_packages_mode: "监视模式不支持“包”样式的入口点",
@@ -99,12 +119,15 @@ module.exports = localeUtils.buildIncompleteTranslation({
     failed_to_resolve_0_to_ts_path: "无法将 package.json 中的入口点 {0} 解析至 TypeScript 源文件",
     use_expand_or_glob_for_files_in_dir: "如果要包含此目录中的文件，请设置 --entryPointStrategy 以展开或指定 glob",
     glob_0_did_not_match_any_files: "glob {0} 与任何文件均不匹配",
+    glob_should_use_posix_slash: `请将 Windows 路径分隔符（\\）替换为 POSIX 路径分隔符（/）`,
     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} 不是对象",
+    // deserialization
     serialized_project_referenced_0_not_part_of_project: "序列化项目引用了反射 {0}，但它不是项目的一部分",
     saved_relative_path_0_resolved_from_1_is_not_a_file: "序列化项目引用的 {0} 不存在或无法在 {1} 下找到",
+    // options
     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}”选项只能通过配置文件指定",
@@ -120,8 +143,10 @@ module.exports = localeUtils.buildIncompleteTranslation({
     invalid_tsdoc_json_0: "文件 {0} 不是有效的 tsdoc.json 文件",
     options_file_0_does_not_exist: "选项文件 {0} 不存在",
     failed_read_options_file_0: "无法解析 {0}，请确保其存在并导出对象",
+    // plugins
     invalid_plugin_0_missing_load_function: "插件 {0} 中的结构无效，未找到加载函数",
     plugin_0_could_not_be_loaded: "无法加载插件 {0}",
+    // option declarations help
     help_options: "指定应加载的 json 选项文件。如果未指定，TypeDoc 将在当前目录中查找“typedoc.json”",
     help_tsconfig: "指定应加载的 TypeScript 配置文件。如果未指定，TypeDoc 将在当前目录中查找“tsconfig.json”",
     help_compilerOptions: "有选择地覆盖 TypeDoc 使用的 TypeScript 编译器选项",
@@ -149,6 +174,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_pretty: "指定输出 JSON 是否应使用制表符进行格式化",
     help_emit: "指定 TypeDoc 应发出的内容，“docs”、“both”或“none”",
     help_theme: "指定用于呈现文档的主题名称",
+    help_router: "指定需要使用路由的名称以决定文档中文件的命名方式",
     help_lightHighlightTheme: "指定浅色模式下的代码高亮主题",
     help_darkHighlightTheme: "指定暗黑模式下的代码高亮主题",
     help_highlightLanguages: "指定渲染时将加载的代码高亮语言",
@@ -169,6 +195,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_basePath: "指定显示文件路径时使用的基本路径",
     help_excludeTags: "从文档注释中删除列出的块级/修饰符标签",
     help_notRenderedTags: "保留在文档注释中但在创建输出时不渲染的标签",
+    help_cascadedModifierTags: "需要从父反射复制至所有子反射的修饰符标签",
     help_readme: "应显示在索引页上的自述文件路径。传递“none”以禁用索引页并在全局页上启动文档",
     help_cname: "设置 CNAME 文件文本，这对于 GitHub Pages 上的自定义域很有用",
     help_favicon: "作为站点图标包含的 favicon 的路径",
@@ -197,6 +224,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_searchGroupBoosts: "配置搜索以增强所选种类（例如“类别”）的相关性",
     help_useFirstParagraphOfCommentAsSummary: "如果设置，且没有指定 @summary 标签，TypeDoc 会使用注释的第一行作为在模块/命名空间一览里的概述",
     help_jsDocCompatibility: "设置注释解析的兼容性选项，以增加与 JSDoc 注释的相似度",
+    help_suppressCommentWarningsInDeclarationFiles: "阻止 .d.ts 文件的注释中因为存在未指定的标签而弹出的警告。",
     help_commentStyle: "确定 TypeDoc 如何搜索注释",
     help_useTsLinkResolution: "使用 TypeScript 的链接解析来确定 @link 标签指向的位置。这仅适用于 JSDoc 样式注释",
     help_preserveLinkText: "如果设置，不带链接文本的 @link 标签将使用文本内容作为链接。如果未设置，将使用目标反射名称",
@@ -221,9 +249,14 @@ module.exports = localeUtils.buildIncompleteTranslation({
     help_logLevel: "指定应使用什么级别的日志记录",
     help_treatWarningsAsErrors: "如果设置，所有警告都将被视为错误",
     help_treatValidationWarningsAsErrors: "如果设置，验证期间发出的警告将被视为错误。此选项不能用于禁用验证警告的 treatWarningsAsErrors",
-    help_intentionallyNotExported: "不应产生“引用但未记录”警告的类型列表",
-    help_requiredToBeDocumented: "必须记录的反射类型列表",
+    help_intentionallyNotExported: "不会因为“引用但并未导出”而产生警告的符号列表",
+    help_requiredToBeDocumented: "需要有文档说明的反射类型列表",
+    help_packagesRequiringDocumentation: "需要有文档说明的包的列表",
+    help_intentionallyNotDocumented: "不会因为无文档说明而产生警告的完整反射名称列表",
     help_validation: "指定 TypeDoc 应对生成的文档执行哪些验证步骤",
+    // ==================================================================
+    // Option validation
+    // ==================================================================
     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}",
@@ -250,11 +283,13 @@ module.exports = localeUtils.buildIncompleteTranslation({
     option_0_specified_1_but_only_2_is_valid: "{0} 只能指定已知值，并且提供了无效值 ({1})。有效的排序策略为：\n{2}",
     option_outputs_must_be_array: "“outputs” 选项必须为一个数组，其成员均为 { name: string, path: string, options?: TypeDocOptions }。",
     specified_output_0_has_not_been_defined: "指定的输出类型 {0} 未被定义。",
+    // https://docs.github.com/en/get-started/writing-on-github/getting-started-with-writing-and-formatting-on-github/basic-writing-and-formatting-syntax#alerts
     alert_note: "注意",
     alert_tip: "提示",
     alert_important: "重要",
     alert_warning: "警告",
     alert_caution: "小心",
+    // ReflectionKind singular translations
     kind_project: "项目",
     kind_module: "模块",
     kind_namespace: "命名空间",
@@ -279,6 +314,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     kind_type_alias: "类型别名",
     kind_reference: "参考",
     kind_document: "文档",
+    // ReflectionKind plural translations
     kind_plural_project: "项目",
     kind_plural_module: "模块",
     kind_plural_namespace: "命名空间",
@@ -303,6 +339,7 @@ module.exports = localeUtils.buildIncompleteTranslation({
     kind_plural_type_alias: "类型别名",
     kind_plural_reference: "参考",
     kind_plural_document: "文档",
+    // ReflectionFlag translations
     flag_private: "私有",
     flag_protected: "受保护",
     flag_public: "公开",
@@ -314,6 +351,10 @@ module.exports = localeUtils.buildIncompleteTranslation({
     flag_const: "常量",
     flag_readonly: "只读",
     flag_inherited: "继承",
+    // ==================================================================
+    // Strings that show up in the default theme
+    // ==================================================================
+    // Page headings/labels
     theme_implements: "实现",
     theme_indexable: "可索引",
     theme_type_declaration: "类型声明",
@@ -327,10 +368,12 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_inherited_from: "继承自",
     theme_overrides: "重写了",
     theme_returns: "返回",
-    theme_generated_using_typedoc: "使用 TypeDoc 生成",
+    theme_generated_using_typedoc: "使用 TypeDoc 生成", // If this includes "TypeDoc", theme will insert a link at that location.
+    // Search
     theme_preparing_search_index: "正在准备搜索索引...",
-    theme_search_index_not_available: "搜索索引不可用",
+    // Left nav bar
     theme_loading: "加载中……",
+    // Right nav bar
     theme_settings: "显示设置",
     theme_member_visibility: "成员可见性",
     theme_theme: "配色",
@@ -338,14 +381,24 @@ module.exports = localeUtils.buildIncompleteTranslation({
     theme_light: "浅色",
     theme_dark: "深色",
     theme_on_this_page: "目录",
+    // aria-label
     theme_search: "搜索",
     theme_menu: "菜单",
     theme_permalink: "永久链接",
+    theme_folder: "文件夹",
+    // Used by the frontend JS
+    // For the English translations only, these should also be added to
+    // src/lib/output/themes/default/assets/typedoc/Application.ts
+    // Also uses theme_folder and singular kinds
     theme_copy: "复制",
     theme_copied: "已复制！",
     theme_normally_hidden: "由于您的过滤器设置，该成员已被隐藏。",
     theme_hierarchy_expand: "展开",
     theme_hierarchy_collapse: "折叠",
+    theme_search_index_not_available: "搜索索引不可用",
+    theme_search_no_results_found_for_0: "找不到包含 {0} 的结果",
+    theme_search_placeholder: "搜索文档",
+    // Block tags
     tag_defaultValue: "默认值",
     tag_deprecated: "已被弃用",
     tag_example: "示例",
@@ -382,12 +435,14 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_type: "类型",
     tag_typedef: "类型定义",
     tag_summary: "概述",
+    // Inline tags
     tag_link: "链接",
     tag_label: "标记",
     tag_linkcode: "链接",
     tag_linkplain: "链接",
     tag_include: "包含",
     tag_includeCode: "包含",
+    // Modifier tags
     tag_alpha: "alpha",
     tag_beta: "beta",
     tag_eventProperty: "事件属性",
@@ -418,4 +473,5 @@ module.exports = localeUtils.buildIncompleteTranslation({
     tag_showCategories: "在类别中显示",
     tag_showGroups: "在分组中显示",
     tag_useDeclaredType: "使用声明类型",
+    tag_primaryExport: "主要导出",
 });

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

@@ -5,6 +5,8 @@ declare const _default: {
     loaded_plugin_0: "已加载插件 {0}";
     solution_not_supported_in_watch_mode: string;
     strategy_not_supported_in_watch_mode: string;
+    file_0_changed_restarting: "配置文件 {0} 已更改：需要重新启动……";
+    file_0_changed_rebuilding: "文件 {0} 已更改：正在重新构建输出……";
     found_0_errors_and_1_warnings: "发现 {0} 个错误和 {1} 个警告";
     output_0_could_not_be_generated: "由于以上错误无法生成 {0} 输出";
     output_0_generated_at_1: "已生成 {0} 输出，位于 {1}";
@@ -54,7 +56,8 @@ declare const _default: {
     failed_to_resolve_link_to_0_in_document_1_may_have_meant_2: "无法解析文档 {1} 中指向 “{0}” 的链接。您可能想要 “{2}”";
     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}";
+    invalid_intentionally_not_documented_names_0: "以下的限定反射名称被设定为刻意无文档说明，但它们要么未在文档中被引用，要么已有文档说明：\n\t{0}";
+    invalid_intentionally_not_exported_symbols_0: "以下符号被设定为刻意非导出，但它们要么未在文档中被引用，要么已为导出符号：\n{0}";
     reflection_0_has_unused_mergeModuleWith_tag: "{0} 中存在无法解析的 @mergeModuleWith 标签";
     reflection_0_links_to_1_with_text_2_but_resolved_to_3: "“{0}”中的链接“{2}”指向“{1}”，目标虽然存在但并没有直接的链接，因此将改为链接至“{3}”。";
     not_all_search_category_boosts_used_0: "文档中并未使用 searchCategoryBoosts 中指定的所有类别。未使用的类别包括：\n{0}";
@@ -76,6 +79,16 @@ declare const _default: {
     reflection_0_tried_to_merge_into_child_1: "反射 {0} 尝试使用 @mergeModuleWith 合并到其子项之一：{1}";
     include_0_in_1_specified_2_resolved_to_3_does_not_exist: "{1} 的注释中 {0} 标签指定了包含 “{2}”，解析为 “{3}”，该文件并不存在或并非文件。";
     include_0_in_1_specified_2_circular_include_3: "{1} 的注释中 {0} 标签指定了包含 “{2}”，导致了循环包含：\n\t{3}";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_not_found: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件找不到该区域。";
+    include_0_tag_in_1_region_2_region_not_supported: "{1} 中的 标签 {0} 指定了 “{2}”，但尚不支持对应的文件扩展名。";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_close_not_found: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中找不到该区域的结束注释。";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_open_not_found: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中找不到该区域的起始注释。";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_close_found_multiple_times: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域的结束注释出现了多次。";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_open_found_multiple_times: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域的起始注释出现了多次。";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_found_multiple_times: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域出现了多次。";
+    include_0_tag_in_1_specified_2_file_3_region_4_region_empty: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中标记为 “{4}” 的区域，但在对应的文件中该区域不包含内容或仅包含空白字符。";
+    include_0_tag_in_1_specified_2_file_3_lines_4_invalid_range: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中的 {4} 行，但指定的行范围无效。";
+    include_0_tag_in_1_specified_2_file_3_lines_4_but_only_5_lines: "{1} 中的标签 {0} 指定 “{2}” 以包含文件 “{3}” 中的 {4} 行，但该文件只有 {5} 行。";
     custom_css_file_0_does_not_exist: "{0} 处的自定义 CSS 文件不存在";
     custom_js_file_0_does_not_exist: "{0} 处的自定义 JavaScript 文件不存在";
     unsupported_highlight_language_0_not_highlighted_in_comment_for_1: "{1} 的注释中使用了不支持的高亮语言 {0} ，因此该语言将不会被高亮";
@@ -85,6 +98,7 @@ declare const _default: {
     could_not_empty_output_directory_0: "无法清空输出目录 {0}";
     could_not_create_output_directory_0: "无法创建输出目录 {0}";
     theme_0_is_not_defined_available_are_1: "主题“{0}”未定义。可用主题为：{1}";
+    router_0_is_not_defined_available_are_1: "路由 “{0}” 未定义。可用的路由为：{1}";
     reflection_0_links_to_1_but_anchor_does_not_exist_try_2: "{0} 链接至 {1}，但对应锚点不存在。你是否是指：\n\t{2}";
     no_entry_points_provided: string;
     unable_to_find_any_entry_points: string;
@@ -94,6 +108,7 @@ declare const _default: {
     failed_to_resolve_0_to_ts_path: "无法将 package.json 中的入口点 {0} 解析至 TypeScript 源文件";
     use_expand_or_glob_for_files_in_dir: string;
     glob_0_did_not_match_any_files: "glob {0} 与任何文件均不匹配";
+    glob_should_use_posix_slash: string;
     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 的目录不匹配";
@@ -144,6 +159,7 @@ declare const _default: {
     help_pretty: string;
     help_emit: string;
     help_theme: string;
+    help_router: string;
     help_lightHighlightTheme: string;
     help_darkHighlightTheme: string;
     help_highlightLanguages: string;
@@ -164,6 +180,7 @@ declare const _default: {
     help_basePath: string;
     help_excludeTags: string;
     help_notRenderedTags: string;
+    help_cascadedModifierTags: string;
     help_readme: string;
     help_cname: string;
     help_favicon: string;
@@ -192,6 +209,7 @@ declare const _default: {
     help_searchGroupBoosts: string;
     help_useFirstParagraphOfCommentAsSummary: string;
     help_jsDocCompatibility: string;
+    help_suppressCommentWarningsInDeclarationFiles: string;
     help_commentStyle: string;
     help_useTsLinkResolution: string;
     help_preserveLinkText: string;
@@ -218,6 +236,8 @@ declare const _default: {
     help_treatValidationWarningsAsErrors: string;
     help_intentionallyNotExported: string;
     help_requiredToBeDocumented: string;
+    help_packagesRequiringDocumentation: string;
+    help_intentionallyNotDocumented: 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} 之间";
@@ -324,7 +344,6 @@ declare const _default: {
     theme_returns: string;
     theme_generated_using_typedoc: string;
     theme_preparing_search_index: string;
-    theme_search_index_not_available: string;
     theme_loading: string;
     theme_settings: string;
     theme_member_visibility: string;
@@ -336,11 +355,15 @@ declare const _default: {
     theme_search: string;
     theme_menu: string;
     theme_permalink: string;
+    theme_folder: string;
     theme_copy: string;
     theme_copied: string;
     theme_normally_hidden: string;
     theme_hierarchy_expand: string;
     theme_hierarchy_collapse: string;
+    theme_search_index_not_available: string;
+    theme_search_no_results_found_for_0: "找不到包含 {0} 的结果";
+    theme_search_placeholder: string;
     tag_defaultValue: string;
     tag_deprecated: string;
     tag_example: string;
@@ -413,5 +436,6 @@ declare const _default: {
     tag_showCategories: string;
     tag_showGroups: string;
     tag_useDeclaredType: string;
+    tag_primaryExport: string;
 };
 export = _default;

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

@@ -15,6 +15,7 @@ type TranslationConstraint = [
     BuildConstraint<0 | 1>,
     BuildConstraint<0 | 1 | 2>,
     BuildConstraint<0 | 1 | 2 | 3>,
-    BuildConstraint<0 | 1 | 2 | 3 | 4>
+    BuildConstraint<0 | 1 | 2 | 3 | 4>,
+    BuildConstraint<0 | 1 | 2 | 3 | 4 | 5>
 ];
 export {};

package/dist/lib/models/{comments/comment.d.ts → Comment.d.ts}

@@ -1,6 +1,7 @@
-import type { Reflection } from "../reflections/index.js";
-import { ReflectionSymbolId } from "../reflections/ReflectionSymbolId.js";
-import type { Serializer, Deserializer, JSONOutput } from "../../serialization/index.js";
+import { type NormalizedPath } from "#utils";
+import type { Reflection } from "./Reflection.js";
+import { ReflectionSymbolId } from "./ReflectionSymbolId.js";
+import type { Deserializer, JSONOutput, Serializer } from "#serialization";
 /**
  * Represents a parsed piece of a comment.
  * @category Comments
@@ -17,7 +18,7 @@ export type CommentDisplayPart =
 /**
  * Represents a code block separated out form the plain text entry so
  * that TypeDoc knows to skip it when parsing relative links and inline tags.
- **/
+ */
  | {
     kind: "code";
     text: string;
@@ -104,7 +105,7 @@ export declare class CommentTag {
      */
     similarTo(other: CommentTag): boolean;
     clone(): CommentTag;
-    toObject(serializer: Serializer): JSONOutput.CommentTag;
+    toObject(): JSONOutput.CommentTag;
     fromObject(de: Deserializer, obj: JSONOutput.CommentTag): void;
 }
 /**
@@ -124,9 +125,9 @@ export declare class Comment {
      * Helper utility to clone {@link Comment.summary} or {@link CommentTag.content}
      */
     static cloneDisplayParts(parts: readonly CommentDisplayPart[]): CommentDisplayPart[];
-    static serializeDisplayParts(serializer: Serializer, parts: CommentDisplayPart[]): JSONOutput.CommentDisplayPart[];
+    static serializeDisplayParts(parts: CommentDisplayPart[]): JSONOutput.CommentDisplayPart[];
     /** @hidden no point in showing this signature in api docs */
-    static serializeDisplayParts(serializer: Serializer, parts: CommentDisplayPart[] | undefined): JSONOutput.CommentDisplayPart[] | undefined;
+    static serializeDisplayParts(parts: CommentDisplayPart[] | undefined): JSONOutput.CommentDisplayPart[] | undefined;
     static deserializeDisplayParts(de: Deserializer, parts: JSONOutput.CommentDisplayPart[]): CommentDisplayPart[];
     /**
      * Splits the provided parts into a header (first line, as a string)
@@ -159,7 +160,7 @@ export declare class Comment {
      *
      * Note: This field is non-enumerable to make testing comment contents with `deepEqual` easier.
      */
-    sourcePath?: string;
+    sourcePath?: NormalizedPath;
     /**
      * Internal discovery ID used to prevent symbol comments from
      * being duplicated on signatures. Only set when the comment was created

package/dist/lib/models/{comments/comment.js → Comment.js}

@@ -32,9 +32,8 @@ var __runInitializers = (this && this.__runInitializers) || function (thisArg, i
     }
     return useValue ? value : void 0;
 };
-import { assertNever, removeIf } from "../../utils/index.js";
-import { ReflectionSymbolId } from "../reflections/ReflectionSymbolId.js";
-import { NonEnumerable } from "../../utils/general.js";
+import { assertNever, i18n, NonEnumerable, removeIf } from "#utils";
+import { ReflectionSymbolId } from "./ReflectionSymbolId.js";
 /**
  * A model that represents a single TypeDoc comment tag.
  *
@@ -86,11 +85,11 @@ export class CommentTag {
         }
         return tag;
     }
-    toObject(serializer) {
+    toObject() {
         return {
             tag: this.tag,
             name: this.name,
-            content: Comment.serializeDisplayParts(serializer, this.content),
+            content: Comment.serializeDisplayParts(this.content),
         };
     }
     fromObject(de, obj) {
@@ -155,7 +154,7 @@ let Comment = (() => {
         static cloneDisplayParts(parts) {
             return parts.map((p) => ({ ...p }));
         }
-        static serializeDisplayParts(serializer, parts) {
+        static serializeDisplayParts(parts) {
             return parts?.map((part) => {
                 switch (part.kind) {
                     case "text":
@@ -171,7 +170,7 @@ let Comment = (() => {
                                 target = part.target.id;
                             }
                             else {
-                                target = part.target.toObject(serializer);
+                                target = part.target.toObject();
                             }
                         }
                         return {
@@ -187,7 +186,7 @@ let Comment = (() => {
                 }
             });
         }
-        //Since display parts are plain objects, this lives here
+        // Since display parts are plain objects, this lives here
         static deserializeDisplayParts(de, parts) {
             const links = [];
             const files = [];
@@ -259,7 +258,7 @@ let Comment = (() => {
                     for (const [oldId, part] of links) {
                         part.target = project.getReflectionById(de.oldIdToNewId[oldId] ?? -1);
                         if (!part.target) {
-                            de.logger.warn(de.application.i18n.serialized_project_referenced_0_not_part_of_project(oldId.toString()));
+                            de.logger.warn(i18n.serialized_project_referenced_0_not_part_of_project(oldId.toString()));
                         }
                     }
                 });
@@ -431,8 +430,7 @@ let Comment = (() => {
             const comment = new Comment(Comment.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;
+            comment.inheritedFromParentDeclaration = this.inheritedFromParentDeclaration;
             return comment;
         }
         /**
@@ -490,7 +488,7 @@ let Comment = (() => {
         }
         toObject(serializer) {
             return {
-                summary: Comment.serializeDisplayParts(serializer, this.summary),
+                summary: Comment.serializeDisplayParts(this.summary),
                 blockTags: serializer.toObjectsOptional(this.blockTags),
                 modifierTags: this.modifierTags.size > 0
                     ? Array.from(this.modifierTags)
@@ -500,12 +498,11 @@ let Comment = (() => {
         }
         fromObject(de, obj) {
             this.summary = Comment.deserializeDisplayParts(de, obj.summary);
-            this.blockTags =
-                obj.blockTags?.map((tagObj) => {
-                    const tag = new CommentTag(tagObj.tag, []);
-                    de.fromObject(tag, tagObj);
-                    return tag;
-                }) || [];
+            this.blockTags = obj.blockTags?.map((tagObj) => {
+                const tag = new CommentTag(tagObj.tag, []);
+                de.fromObject(tag, tagObj);
+                return tag;
+            }) || [];
             this.modifierTags = new Set(obj.modifierTags);
             this.label = obj.label;
         }

package/dist/lib/models/{reflections/container.d.ts → ContainerReflection.d.ts}

@@ -1,10 +1,10 @@
-import { Reflection, type TraverseCallback } from "./abstract.js";
-import { ReflectionCategory } from "../ReflectionCategory.js";
-import { ReflectionGroup } from "../ReflectionGroup.js";
+import { Reflection, type TraverseCallback } from "./Reflection.js";
+import { ReflectionCategory } from "./ReflectionCategory.js";
+import { ReflectionGroup } from "./ReflectionGroup.js";
 import type { ReflectionKind } from "./kind.js";
-import type { Serializer, JSONOutput, Deserializer } from "../../serialization/index.js";
-import type { DocumentReflection } from "./document.js";
-import type { DeclarationReflection } from "./declaration.js";
+import type { Deserializer, JSONOutput, Serializer } from "#serialization";
+import type { DocumentReflection } from "./DocumentReflection.js";
+import type { DeclarationReflection } from "./DeclarationReflection.js";
 /**
  * @category Reflections
  */

package/dist/lib/models/{reflections/container.js → ContainerReflection.js}

@@ -1,7 +1,7 @@
-import { Reflection, TraverseProperty, } from "./abstract.js";
-import { ReflectionCategory } from "../ReflectionCategory.js";
-import { ReflectionGroup } from "../ReflectionGroup.js";
-import { removeIfPresent } from "../../utils/index.js";
+import { Reflection, TraverseProperty } from "./Reflection.js";
+import { ReflectionCategory } from "./ReflectionCategory.js";
+import { ReflectionGroup } from "./ReflectionGroup.js";
+import { removeIfPresent } from "#utils";
 /**
  * @category Reflections
  */
@@ -123,7 +123,6 @@ export class ContainerReflection extends Reflection {
         }
         if (byId.size) {
             // Anything left in byId wasn't included in the childrenIncludingDocuments array.
-            // This is expected if we're dealing with a JSON file produced by TypeDoc 0.25.
             this.childrenIncludingDocuments ||= [];
             this.childrenIncludingDocuments.push(...byId.values());
         }

package/dist/lib/models/{reflections/declaration.d.ts → DeclarationReflection.d.ts}

@@ -1,12 +1,11 @@
-import type ts from "typescript";
-import { type ReferenceType, type SomeType } from "../types.js";
-import { type TraverseCallback } from "./abstract.js";
-import { ContainerReflection } from "./container.js";
-import type { SignatureReflection } from "./signature.js";
-import type { TypeParameterReflection } from "./type-parameter.js";
-import type { Serializer, JSONOutput, Deserializer } from "../../serialization/index.js";
-import { type CommentDisplayPart } from "../comments/index.js";
-import { SourceReference } from "../sources/file.js";
+import { type ReferenceType, type SomeType } from "./types.js";
+import { type TraverseCallback } from "./Reflection.js";
+import { ContainerReflection } from "./ContainerReflection.js";
+import type { SignatureReflection } from "./SignatureReflection.js";
+import type { TypeParameterReflection } from "./TypeParameterReflection.js";
+import type { Deserializer, JSONOutput, Serializer } from "#serialization";
+import { type CommentDisplayPart } from "./Comment.js";
+import { SourceReference } from "./SourceReference.js";
 /**
  * Stores hierarchical type data.
  *
@@ -30,7 +29,7 @@ export interface DeclarationHierarchy {
  * A reflection that represents a single declaration emitted by the TypeScript compiler.
  *
  * All parts of a project are represented by DeclarationReflection instances. The actual
- * kind of a reflection is stored in its ´kind´ member.
+ * kind of a reflection is stored in its `kind` member.
  * @category Reflections
  */
 export declare class DeclarationReflection extends ContainerReflection {
@@ -39,21 +38,14 @@ export declare class DeclarationReflection extends ContainerReflection {
      * A list of all source files that contributed to this reflection.
      */
     sources?: SourceReference[];
-    /**
-     * Precomputed boost for search results, may be less than 1 to de-emphasize this member in search results.
-     * Does NOT include group/category values as they are computed when building the JS index.
-     *
-     * This is preserved for plugins, and may be removed in 0.28 if no plugins have used it yet.
-     */
-    relevanceBoost?: number;
     /**
      * The escaped name of this declaration assigned by the TS compiler if there is an associated symbol.
      * This is used to retrieve properties for analyzing inherited members.
      *
-     * Not serialized, only useful during conversion.
+     * Not serialized, only useful during conversion. This is a `ts.__String`.
      * @internal
      */
-    escapedName?: ts.__String;
+    escapedName?: string;
     /**
      * The type of the reflection.
      *