@scribdown/shared 0.2.0 → 0.4.0

package/dist/index.d.ts

@@ -374,7 +374,7 @@ declare const PROJECT_HOMEPAGE_URL = "https://share-man-man.github.io/scribdown/
 /**
  * 当前项目固定 Node.js LTS 版本。
  */
-declare const NODE_LTS_VERSION = "24.15.0";
+declare const NODE_LTS_VERSION = "24.18.0";
 /**
  * 当前项目支持的平台列表。
  */
@@ -525,4 +525,389 @@ declare const SCRIBDOWN_TOOLBAR_CURRENT_TEXT_CLASS_NAME = "scribdown-toolbar-cur
  */
 declare const CONTENT_WIDTH_STORAGE_KEY = "scribdown-content-width";
 
-export { CODE_BLOCK_BODY_CLASS_NAME, CODE_BLOCK_CHROME_CLASS_NAME, CODE_BLOCK_CLASS_NAME, CODE_BLOCK_COPY_CLASS_NAME, CODE_BLOCK_COPY_ICON_CHECK_CLASS_NAME, CODE_BLOCK_COPY_ICON_CLASS_NAME, CODE_BLOCK_COPY_ICON_COPY_CLASS_NAME, CODE_BLOCK_GUTTER_CLASS_NAME, CODE_BLOCK_GUTTER_LINE_CLASS_NAME, CODE_BLOCK_LANG_CLASS_NAME, CODE_BLOCK_LINE_CLASS_NAME, CONTENT_WIDTH_STORAGE_KEY, DEFAULT_THEME, DETAILS_CLASS_NAME, FRAME_CLASS_NAME, FRONTMATTER_CHROME_CLASS_NAME, FRONTMATTER_CLASS_NAME, FRONTMATTER_LABEL_CLASS_NAME, FRONTMATTER_LIST_CLASS_NAME, FRONTMATTER_LIST_NESTED_CLASS_NAME, HEADING_MARK_CLASS_NAME, IMAGE_CAPTION_CLASS_NAME, IMAGE_ELEMENT_CLASS_NAME, IMAGE_FALLBACK_CLASS_NAME, IMAGE_FALLBACK_ICON_CLASS_NAME, IMAGE_FALLBACK_SOURCE_CLASS_NAME, IMAGE_FALLBACK_TEXT_CLASS_NAME, IMAGE_FIGURE_CLASS_NAME, IMAGE_FRAME_CLASS_NAME, IMAGE_FRAME_FAILED_CLASS_NAME, IMAGE_FRAME_LOADED_CLASS_NAME, IMAGE_VIEWER_BUTTON_CLASS_NAME, IMAGE_VIEWER_CAPTION_CLASS_NAME, IMAGE_VIEWER_CAPTION_GROUP_CLASS_NAME, IMAGE_VIEWER_CHROME_CLASS_NAME, IMAGE_VIEWER_CLOSE_BUTTON_CLASS_NAME, IMAGE_VIEWER_CONTROLS_CLASS_NAME, IMAGE_VIEWER_DIALOG_CLASS_NAME, IMAGE_VIEWER_DRAGGING_CLASS_NAME, IMAGE_VIEWER_HINT_CLASS_NAME, IMAGE_VIEWER_IMAGE_CLASS_NAME, IMAGE_VIEWER_VIEWPORT_CLASS_NAME, IMAGE_VIEWER_ZOOMED_CLASS_NAME, IMAGE_VIEWER_ZOOM_VALUE_CLASS_NAME, MARKDOWN_FILE_EXTNAME, MARKDOWN_LANGUAGE_ID, MERMAID_BODY_CLASS_NAME, MERMAID_CANVAS_CLASS_NAME, MERMAID_CHROME_CLASS_NAME, MERMAID_FALLBACK_CLASS_NAME, MERMAID_FALLBACK_ICON_CLASS_NAME, MERMAID_FALLBACK_SOURCE_CLASS_NAME, MERMAID_FALLBACK_TEXT_CLASS_NAME, MERMAID_FIGURE_CLASS_NAME, MERMAID_FIGURE_FAILED_CLASS_NAME, MERMAID_FIGURE_LOADED_CLASS_NAME, MERMAID_FIGURE_LOADING_CLASS_NAME, MERMAID_FULLSCREEN_BUTTON_CLASS_NAME, MERMAID_LABEL_CLASS_NAME, MERMAID_VIEWER_BUTTON_CLASS_NAME, MERMAID_VIEWER_CANVAS_CLASS_NAME, MERMAID_VIEWER_CAPTION_CLASS_NAME, MERMAID_VIEWER_CHROME_CLASS_NAME, MERMAID_VIEWER_CLOSE_BUTTON_CLASS_NAME, MERMAID_VIEWER_CONTROLS_CLASS_NAME, MERMAID_VIEWER_DIALOG_CLASS_NAME, MERMAID_VIEWER_DRAGGING_CLASS_NAME, MERMAID_VIEWER_VIEWPORT_CLASS_NAME, MERMAID_VIEWER_ZOOMED_CLASS_NAME, MERMAID_VIEWER_ZOOM_VALUE_CLASS_NAME, NODE_LTS_VERSION, OPEN_PREVIEW_COMMAND, PROJECT_HOMEPAGE_URL, PROJECT_NAME, PlatformType, SCRIBDOWN_APP_CLASS_NAME, SCRIBDOWN_CONTENT_AREA_CLASS_NAME, SCRIBDOWN_CONTENT_SCROLL_CLASS_NAME, SCRIBDOWN_MARKDOWN_CLASS_NAME, SCRIBDOWN_PAGE_CLASS_NAME, SCRIBDOWN_THIN_SCROLLBAR_CLASS_NAME, SCRIBDOWN_TOC_HOST_CLASS_NAME, SCRIBDOWN_TOOLBAR_BTN_CLASS_NAME, SCRIBDOWN_TOOLBAR_CLASS_NAME, SCRIBDOWN_TOOLBAR_CURRENT_CLASS_NAME, SCRIBDOWN_TOOLBAR_CURRENT_TEXT_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_GROUP_CHOICES_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_GROUP_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_ITEM_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SELECT_CHEVRON_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SELECT_LABEL_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SELECT_VALUE_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SUB_ITEM_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SUB_ITEM_LABEL_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SUB_ITEM_MARK_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_CLOSE_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_EMPTY_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_TITLE_CLASS_NAME, SOURCE_LINE_ACTIVE_CLASS_NAME, SOURCE_LINE_DATA_ATTRIBUTE, SOURCE_LINE_OFFSCREEN_HINT_BOTTOM_CLASS_NAME, SOURCE_LINE_OFFSCREEN_HINT_CLASS_NAME, SOURCE_LINE_OFFSCREEN_HINT_TOP_CLASS_NAME, SUPPORTED_PLATFORMS, TOC_CLASS_NAME, TOC_ITEM_BRANCH_CLASS_NAME, TOC_ITEM_CLASS_PREFIX, TOC_ITEM_COLLAPSED_CLASS_NAME, TOC_LINK_ACTIVE_CLASS_NAME, TOC_LINK_CLASS_NAME, TOC_LIST_CLASS_NAME, TOC_LIST_NESTED_CLASS_NAME, TOC_NAV_CLASS_NAME, TOC_SUMMARY_CLASS_NAME, TOC_TOGGLE_CLASS_NAME, ThemeType, VIDEO_ELEMENT_CLASS_NAME, VIDEO_FALLBACK_CLASS_NAME, VIDEO_FALLBACK_ICON_CLASS_NAME, VIDEO_FALLBACK_SOURCE_CLASS_NAME, VIDEO_FALLBACK_TEXT_CLASS_NAME, VIDEO_FIGURE_CLASS_NAME, VIDEO_FRAME_CLASS_NAME, VIDEO_FRAME_FAILED_CLASS_NAME, VIDEO_FRAME_LOADED_CLASS_NAME };
+/**
+ * Scribdown 国际化「语言」契约。
+ * 统一收敛支持的 locale、默认兜底、回落链，以及各宿主静态文件（Chrome _locales、
+ * VS Code package.nls）的目录/后缀命名映射，禁止在其他包重新定义或硬编码。
+ */
+/**
+ * 支持的界面语言枚举（BCP-47 规范写法）。
+ * 新增语言时在此追加，并在 {@link SUPPORTED_LOCALES}、{@link LOCALE_FALLBACKS}、
+ * messages 目录三处补齐即可，无需改动接线逻辑。
+ */
+declare enum LocaleType {
+    /** 英语（默认兜底语言）。 */
+    English = "en",
+    /** 简体中文。 */
+    SimplifiedChinese = "zh-CN",
+    /** 繁体中文。 */
+    TraditionalChinese = "zh-TW",
+    /** 日语。 */
+    Japanese = "ja",
+    /** 韩语。 */
+    Korean = "ko",
+    /** 西班牙语。 */
+    Spanish = "es",
+    /** 法语。 */
+    French = "fr",
+    /** 德语。 */
+    German = "de",
+    /** 巴西葡萄牙语。 */
+    BrazilianPortuguese = "pt-BR",
+    /** 俄语。 */
+    Russian = "ru"
+}
+/**
+ * 默认兜底语言：无法识别宿主语言、或某语言缺失文案时最终回落到此。
+ */
+declare const DEFAULT_LOCALE: LocaleType;
+/**
+ * 界面语言偏好。`System` 表示未显式选择语言，跟随浏览器或编辑器的系统界面语言。
+ * 宿主负责将该值持久化到自己的全局配置；共享层只负责解析，避免耦合 Web Storage。
+ */
+declare enum LocalePreference {
+    /** 跟随宿主系统界面语言。 */
+    System = "system",
+    /** 始终使用英语。 */
+    English = "en",
+    /** 始终使用简体中文。 */
+    SimplifiedChinese = "zh-CN",
+    /** 始终使用繁体中文。 */
+    TraditionalChinese = "zh-TW",
+    /** 始终使用日语。 */
+    Japanese = "ja",
+    /** 始终使用韩语。 */
+    Korean = "ko",
+    /** 始终使用西班牙语。 */
+    Spanish = "es",
+    /** 始终使用法语。 */
+    French = "fr",
+    /** 始终使用德语。 */
+    German = "de",
+    /** 始终使用巴西葡萄牙语。 */
+    BrazilianPortuguese = "pt-BR",
+    /** 始终使用俄语。 */
+    Russian = "ru"
+}
+/**
+ * 当前支持的全部语言列表（用于校验入参、遍历生成静态文件）。
+ */
+declare const SUPPORTED_LOCALES: LocaleType[];
+/** 工具栏与宿主配置共用的可选语言定义。 */
+interface LocalePreferenceOption {
+    /** 持久化到宿主配置的显式语言偏好。 */
+    preference: Exclude<LocalePreference, LocalePreference.System>;
+    /** 此偏好对应的实际界面语言。 */
+    locale: LocaleType;
+    /** 语言的原生自称，跨界面语言保持一致，便于识别和切换。 */
+    nativeLabel: string;
+}
+/** 语言选择器按稳定顺序展示的全部显式语言选项；跟随应用语言是未设置偏好的默认行为。 */
+declare const LOCALE_PREFERENCE_OPTIONS: readonly LocalePreferenceOption[];
+/**
+ * 各语言的回落链：命中语言缺失某 key 时，按顺序回落到链上语言，最终止于 {@link DEFAULT_LOCALE}。
+ * 默认语言自身链为空。
+ */
+declare const LOCALE_FALLBACKS: Record<LocaleType, LocaleType[]>;
+/**
+ * 语言 → Chrome 扩展 `_locales/<dir>/messages.json` 目录名映射。
+ * Chrome 约定 locale 目录名用下划线（如 `zh_CN`）。
+ */
+declare const CHROME_LOCALE_DIRECTORY: Record<LocaleType, string>;
+/**
+ * 语言 → VS Code `package.nls[.<suffix>].json` 文件名后缀映射。
+ * VS Code 约定后缀用小写连字符（如 `zh-cn`）；默认语言写入无后缀的 `package.nls.json`。
+ */
+declare const VSCODE_NLS_SUFFIX: Record<LocaleType, string>;
+/**
+ * 把宿主上报的原始语言标签归一化成受支持的 {@link LocaleType}。
+ * 逐级降级匹配：先精确命中，再按主语言子标签匹配（如 `zh-Hans-CN` → `zh-CN`），
+ * 全不命中回落到 {@link DEFAULT_LOCALE}。
+ * @param rawLocale 宿主原始语言标签（如 `navigator.language`、`vscode.env.language`），大小写与分隔符不限。
+ * @returns 归一化后的受支持语言。
+ */
+declare function normalizeLocale(rawLocale: string | null | undefined): LocaleType;
+/**
+ * 解析宿主保存的语言偏好。非法值安全回落到 {@link LocalePreference.System}。
+ * @param rawPreference 宿主配置或存储中读到的原始值。
+ * @returns 合法的语言偏好。
+ */
+declare function normalizeLocalePreference(rawPreference: unknown): LocalePreference;
+/**
+ * 判断值是否为受支持的语言偏好。
+ * @param value 待校验的原始值。
+ * @returns 值为合法 {@link LocalePreference} 时返回 true。
+ */
+declare function isLocalePreference(value: unknown): value is LocalePreference;
+
+/**
+ * Scribdown 文案目录的结构契约。
+ * 每个受支持语言都必须提供 {@link Messages} 的全部 key（由 Record 类型在编译期约束缺漏），
+ * 保证跨语言 key 对齐；带 `{name}` 的值表示运行时插值占位。
+ */
+/**
+ * 全量文案 key → 文案字符串的映射结构。
+ * key 采用 `<面>.<语义>` 命名，便于按面归组与静态文件生成。
+ */
+interface Messages {
+    /** 工具栏「目录」按钮 / 目录侧栏标题。 */
+    "toolbar.toc": string;
+    /** 目录侧栏右上角关闭按钮 aria-label。 */
+    "toolbar.tocClose": string;
+    /** 目录为空时的占位文案。 */
+    "toolbar.tocEmpty": string;
+    /** 工具栏「更多」按钮。 */
+    "toolbar.more": string;
+    /** 「更多」菜单内「页面宽度」触发行文案。 */
+    "toolbar.pageWidth": string;
+    /** 「更多」菜单内「回到顶部」项。 */
+    "toolbar.backTop": string;
+    /** 「更多」菜单内「语言」切换触发行。 */
+    "toolbar.language": string;
+    /** 语言切换列表中的跟随系统选项。 */
+    "toolbar.languageSystem": string;
+    /** 语言切换列表中的英文选项。 */
+    "toolbar.languageEnglish": string;
+    /** 语言切换列表中的简体中文选项。 */
+    "toolbar.languageSimplifiedChinese": string;
+    /** 语言切换列表中的繁体中文选项。 */
+    "toolbar.languageTraditionalChinese": string;
+    /** 语言切换列表中的日语选项。 */
+    "toolbar.languageJapanese": string;
+    /** 语言切换列表中的韩语选项。 */
+    "toolbar.languageKorean": string;
+    /** 语言切换列表中的西班牙语选项。 */
+    "toolbar.languageSpanish": string;
+    /** 语言切换列表中的法语选项。 */
+    "toolbar.languageFrench": string;
+    /** 语言切换列表中的德语选项。 */
+    "toolbar.languageGerman": string;
+    /** 语言切换列表中的巴西葡萄牙语选项。 */
+    "toolbar.languageBrazilianPortuguese": string;
+    /** 语言切换列表中的俄语选项。 */
+    "toolbar.languageRussian": string;
+    /** 「更多」菜单内「关于」项。 */
+    "toolbar.about": string;
+    /** 代码块复制按钮 aria-label（默认态）。 */
+    "code.copy": string;
+    /** 代码块复制按钮 aria-label（已复制态）。 */
+    "code.copied": string;
+    /** Mermaid 渲染失败占位文案。 */
+    "mermaid.renderFailed": string;
+    /** Mermaid 代码块上的「全屏查看」按钮 aria-label。 */
+    "mermaid.fullscreenButton": string;
+    /** Mermaid 全屏查看对话框 aria-label。 */
+    "mermaid.fullscreen": string;
+    /** Mermaid 全屏查看器放大按钮 aria-label。 */
+    "mermaid.zoomIn": string;
+    /** Mermaid 全屏查看器缩小按钮 aria-label。 */
+    "mermaid.zoomOut": string;
+    /** Mermaid 全屏查看器重置缩放按钮 aria-label。 */
+    "mermaid.zoomReset": string;
+    /** Mermaid 全屏查看器关闭按钮 aria-label。 */
+    "mermaid.close": string;
+    /** 图片查看器无标题时的兜底 aria-label。 */
+    "image.viewFull": string;
+    /** 图片查看器带标题时的 aria-label（插值：{alt} 图片标题）。 */
+    "image.viewFullOf": string;
+    /** 图片加载失败占位文案。 */
+    "image.loadFailed": string;
+    /** 图片查看器快捷键提示文本。 */
+    "image.hint": string;
+    /** 图片查看器放大按钮 aria-label。 */
+    "image.zoomIn": string;
+    /** 图片查看器缩小按钮 aria-label。 */
+    "image.zoomOut": string;
+    /** 图片查看器重置缩放按钮 aria-label。 */
+    "image.zoomReset": string;
+    /** 图片查看器关闭按钮 aria-label。 */
+    "image.close": string;
+    /** 视频加载失败占位文案。 */
+    "video.loadFailed": string;
+    /** 内联目录容器 aria-label / summary 文案。 */
+    "toc.label": string;
+    /** 内联目录子项折叠切换按钮 aria-label。 */
+    "toc.toggle": string;
+    /** Frontmatter 折叠块标题。 */
+    "frontmatter.label": string;
+    /** 顶部启用开关 aria-label。 */
+    "popup.enableAria": string;
+    /** 顶部启用开关 title（已启用）。 */
+    "popup.enabledTitle": string;
+    /** 顶部启用开关 title（已关闭）。 */
+    "popup.disabledTitle": string;
+    /** 扩展关闭时的空态提示。 */
+    "popup.disabledEmpty": string;
+    /** 「允许访问文件网址」未开启横幅标题。 */
+    "popup.fileAccessBannerTitle": string;
+    /** 「允许访问文件网址」未开启横幅说明。 */
+    "popup.fileAccessBannerText": string;
+    /** 横幅「去开启」按钮文案。 */
+    "popup.fileAccessAction": string;
+    /** 横幅「去开启」按钮 aria-label。 */
+    "popup.fileAccessActionAria": string;
+    /** 自动刷新设置分组 aria-label。 */
+    "popup.autoRefreshGroupAria": string;
+    /** 自动刷新开关标签。 */
+    "popup.autoRefreshLabel": string;
+    /** 自动刷新说明按钮 aria-label。 */
+    "popup.autoRefreshInfoAria": string;
+    /** 自动刷新开启态说明气泡（插值：{seconds} 刷新间隔秒数）。 */
+    "popup.autoRefreshOnTip": string;
+    /** 自动刷新关闭态说明气泡。 */
+    "popup.autoRefreshOffTip": string;
+    /** 刷新间隔输入项标签。 */
+    "popup.intervalLabel": string;
+    /** 刷新间隔说明按钮 aria-label。 */
+    "popup.intervalInfoAria": string;
+    /** 刷新间隔取值范围气泡（插值：{min} 最小值、{max} 最大值）。 */
+    "popup.intervalRangeTip": string;
+    /** 刷新间隔单位（秒）。 */
+    "popup.intervalUnit": string;
+    /** 切换后保存成功提示。 */
+    "popup.savedTip": string;
+    /** 扩展关闭时的浏览器工具栏图标 title。 */
+    "browser.disabledTitle": string;
+    /** 未开启「允许访问文件网址」时的工具栏图标 title。 */
+    "browser.fileAccessNeededTitle": string;
+    /** 渲染失败错误页标题。 */
+    "viewer.errorHeading": string;
+    /** 「查看原始链接」跳转文案。 */
+    "viewer.viewRawLink": string;
+    /** 禁止在 iframe 中加载的错误。 */
+    "viewer.errorIframe": string;
+    /** 缺少 src 参数的错误。 */
+    "viewer.errorMissingSrc": string;
+    /** 请求失败错误（插值：{message} 错误信息）。 */
+    "viewer.errorRequestFailed": string;
+    /** 响应非 Markdown 类型的错误（插值：{contentType} 响应内容类型）。 */
+    "viewer.errorNotMarkdown": string;
+    /** Content-Type 未声明时的占位词，用于填充 {contentType}。 */
+    "viewer.contentTypeUndeclared": string;
+    /** 文件内容为空的错误。 */
+    "viewer.errorEmpty": string;
+    /** 不支持的协议错误（插值：{protocol} 协议名）。 */
+    "viewer.errorUnsupportedProtocol": string;
+    /** src 非合法 URL 的错误。 */
+    "viewer.errorInvalidUrl": string;
+    /** 无激活 Markdown 文档时的警告。 */
+    "vscode.noMarkdownWarning": string;
+    /** 无法打开链接的警告（插值：{href} 链接地址）。 */
+    "vscode.openLinkFailed": string;
+    /** 链接目标不存在的警告（插值：{path} 目标路径）。 */
+    "vscode.linkTargetMissing": string;
+    /** 预览渲染失败标题。 */
+    "vscode.renderFailed": string;
+    /** 浏览器扩展商店展示名称。 */
+    "manifest.browserName": string;
+    /** 浏览器扩展商店描述。 */
+    "manifest.browserDescription": string;
+    /** VS Code 扩展展示名称（displayName）。 */
+    "manifest.vscodeDisplayName": string;
+    /** VS Code 扩展描述（description）。 */
+    "manifest.vscodeDescription": string;
+    /** VS Code「打开预览」命令标题。 */
+    "manifest.vscodeCommandTitle": string;
+    /** VS Code 界面语言设置的说明。 */
+    "manifest.vscodeLanguageDescription": string;
+    /** VS Code 界面语言设置中「跟随系统」选项的说明。 */
+    "manifest.vscodeLanguageSystemDescription": string;
+    /** VS Code 界面语言设置中英语选项的说明。 */
+    "manifest.vscodeLanguageEnglishDescription": string;
+    /** VS Code 界面语言设置中简体中文选项的说明。 */
+    "manifest.vscodeLanguageSimplifiedChineseDescription": string;
+    /** VS Code 界面语言设置中繁体中文选项的说明。 */
+    "manifest.vscodeLanguageTraditionalChineseDescription": string;
+    /** VS Code 界面语言设置中日语选项的说明。 */
+    "manifest.vscodeLanguageJapaneseDescription": string;
+    /** VS Code 界面语言设置中韩语选项的说明。 */
+    "manifest.vscodeLanguageKoreanDescription": string;
+    /** VS Code 界面语言设置中西班牙语选项的说明。 */
+    "manifest.vscodeLanguageSpanishDescription": string;
+    /** VS Code 界面语言设置中法语选项的说明。 */
+    "manifest.vscodeLanguageFrenchDescription": string;
+    /** VS Code 界面语言设置中德语选项的说明。 */
+    "manifest.vscodeLanguageGermanDescription": string;
+    /** VS Code 界面语言设置中巴西葡萄牙语选项的说明。 */
+    "manifest.vscodeLanguageBrazilianPortugueseDescription": string;
+    /** VS Code 界面语言设置中俄语选项的说明。 */
+    "manifest.vscodeLanguageRussianDescription": string;
+}
+/**
+ * 文案 key 联合类型，供 `t()` 与 `createTranslator()` 约束调用方只能取已声明的 key。
+ */
+type MessageKey = keyof Messages;
+
+/**
+ * Scribdown 全量文案目录（唯一源）。
+ * 三处运行时（浏览器 popup/viewer、共享工具栏、VS Code 宿主/webview）与两处静态清单
+ * （Chrome `_locales`、VS Code `package.nls`）均以此为准，禁止在各端硬编码或重复定义。
+ * 插值占位统一用 `{name}` 语法，由 translator 在运行时替换。
+ */
+
+/**
+ * 语言 → 文案目录的总表。新增语言时在此登记对应目录。
+ */
+declare const MESSAGES: Record<LocaleType, Messages>;
+
+/**
+ * Scribdown 无框架文案取值内核。
+ * 纯 TS、零第三方依赖，可在浏览器 popup（React）、纯 DOM 工具栏、VS Code webview 与
+ * Node 宿主中一致运行。宿主启动时按语言调一次 {@link setActiveLocale}，其余代码用 {@link t}
+ * 取文案；需要多语言并存时用 {@link createTranslator} 取独立实例。
+ */
+
+/**
+ * 插值变量映射：把文案中的 `{name}` 占位替换为对应值。
+ */
+type MessageVars = Record<string, string | number>;
+/**
+ * 设置全局生效语言。非受支持语言会被静默回落到 {@link DEFAULT_LOCALE}，避免脏输入。
+ * @param locale 目标语言（应为受支持的 {@link LocaleType}）。
+ */
+declare function setActiveLocale(locale: LocaleType): void;
+/**
+ * 读取当前全局生效语言。
+ * @returns 当前语言。
+ */
+declare function getActiveLocale(): LocaleType;
+/**
+ * 按「显式语言偏好优先，系统语言其次」解析当前应使用的语言。
+ * @param preference 宿主持久化的语言偏好；省略时视为跟随系统。
+ * @param rawHostLocale 宿主原始语言标签（如 `navigator.language`、`vscode.env.language`）。
+ * @returns 实际应生效的受支持语言。
+ */
+declare function resolveLocalePreference(preference: LocalePreference | undefined, rawHostLocale: string | null | undefined): LocaleType;
+/**
+ * 根据宿主保存的偏好和系统语言更新全局界面语言。
+ * @param preference 宿主持久化的语言偏好；省略时跟随系统。
+ * @param rawHostLocale 宿主原始语言标签。
+ * @returns 实际生效的语言。
+ */
+declare function setActiveLocaleFromPreference(preference: LocalePreference | undefined, rawHostLocale: string | null | undefined): LocaleType;
+/**
+ * 便捷方法：把宿主原始语言标签归一化后设为全局语言。
+ * @param rawLocale 宿主原始语言标签（如 `navigator.language`、`vscode.env.language`）。
+ * @returns 实际生效的语言。
+ */
+declare function setActiveLocaleFromHost(rawLocale: string | null | undefined): LocaleType;
+/**
+ * 按当前全局语言取文案。
+ * @param key 文案 key。
+ * @param vars 可选插值变量。
+ * @returns 已解析并插值的文案。
+ */
+declare function t(key: MessageKey, vars?: MessageVars): string;
+/**
+ * 翻译函数类型：绑定固定语言的取文案方法。
+ */
+type Translator = (key: MessageKey, vars?: MessageVars) => string;
+/**
+ * 创建绑定固定语言的独立翻译器，不受全局语言影响。
+ * 适用于多语言并存、或需要显式指定语言的场景（如静态清单生成）。
+ * @param locale 目标语言，接受原始标签或 {@link LocaleType}，会归一化到受支持语言。
+ * @returns 绑定该语言的翻译函数。
+ */
+declare function createTranslator(locale: LocaleType | string): Translator;
+
+export { CHROME_LOCALE_DIRECTORY, CODE_BLOCK_BODY_CLASS_NAME, CODE_BLOCK_CHROME_CLASS_NAME, CODE_BLOCK_CLASS_NAME, CODE_BLOCK_COPY_CLASS_NAME, CODE_BLOCK_COPY_ICON_CHECK_CLASS_NAME, CODE_BLOCK_COPY_ICON_CLASS_NAME, CODE_BLOCK_COPY_ICON_COPY_CLASS_NAME, CODE_BLOCK_GUTTER_CLASS_NAME, CODE_BLOCK_GUTTER_LINE_CLASS_NAME, CODE_BLOCK_LANG_CLASS_NAME, CODE_BLOCK_LINE_CLASS_NAME, CONTENT_WIDTH_STORAGE_KEY, DEFAULT_LOCALE, DEFAULT_THEME, DETAILS_CLASS_NAME, FRAME_CLASS_NAME, FRONTMATTER_CHROME_CLASS_NAME, FRONTMATTER_CLASS_NAME, FRONTMATTER_LABEL_CLASS_NAME, FRONTMATTER_LIST_CLASS_NAME, FRONTMATTER_LIST_NESTED_CLASS_NAME, HEADING_MARK_CLASS_NAME, IMAGE_CAPTION_CLASS_NAME, IMAGE_ELEMENT_CLASS_NAME, IMAGE_FALLBACK_CLASS_NAME, IMAGE_FALLBACK_ICON_CLASS_NAME, IMAGE_FALLBACK_SOURCE_CLASS_NAME, IMAGE_FALLBACK_TEXT_CLASS_NAME, IMAGE_FIGURE_CLASS_NAME, IMAGE_FRAME_CLASS_NAME, IMAGE_FRAME_FAILED_CLASS_NAME, IMAGE_FRAME_LOADED_CLASS_NAME, IMAGE_VIEWER_BUTTON_CLASS_NAME, IMAGE_VIEWER_CAPTION_CLASS_NAME, IMAGE_VIEWER_CAPTION_GROUP_CLASS_NAME, IMAGE_VIEWER_CHROME_CLASS_NAME, IMAGE_VIEWER_CLOSE_BUTTON_CLASS_NAME, IMAGE_VIEWER_CONTROLS_CLASS_NAME, IMAGE_VIEWER_DIALOG_CLASS_NAME, IMAGE_VIEWER_DRAGGING_CLASS_NAME, IMAGE_VIEWER_HINT_CLASS_NAME, IMAGE_VIEWER_IMAGE_CLASS_NAME, IMAGE_VIEWER_VIEWPORT_CLASS_NAME, IMAGE_VIEWER_ZOOMED_CLASS_NAME, IMAGE_VIEWER_ZOOM_VALUE_CLASS_NAME, LOCALE_FALLBACKS, LOCALE_PREFERENCE_OPTIONS, LocalePreference, type LocalePreferenceOption, LocaleType, MARKDOWN_FILE_EXTNAME, MARKDOWN_LANGUAGE_ID, MERMAID_BODY_CLASS_NAME, MERMAID_CANVAS_CLASS_NAME, MERMAID_CHROME_CLASS_NAME, MERMAID_FALLBACK_CLASS_NAME, MERMAID_FALLBACK_ICON_CLASS_NAME, MERMAID_FALLBACK_SOURCE_CLASS_NAME, MERMAID_FALLBACK_TEXT_CLASS_NAME, MERMAID_FIGURE_CLASS_NAME, MERMAID_FIGURE_FAILED_CLASS_NAME, MERMAID_FIGURE_LOADED_CLASS_NAME, MERMAID_FIGURE_LOADING_CLASS_NAME, MERMAID_FULLSCREEN_BUTTON_CLASS_NAME, MERMAID_LABEL_CLASS_NAME, MERMAID_VIEWER_BUTTON_CLASS_NAME, MERMAID_VIEWER_CANVAS_CLASS_NAME, MERMAID_VIEWER_CAPTION_CLASS_NAME, MERMAID_VIEWER_CHROME_CLASS_NAME, MERMAID_VIEWER_CLOSE_BUTTON_CLASS_NAME, MERMAID_VIEWER_CONTROLS_CLASS_NAME, MERMAID_VIEWER_DIALOG_CLASS_NAME, MERMAID_VIEWER_DRAGGING_CLASS_NAME, MERMAID_VIEWER_VIEWPORT_CLASS_NAME, MERMAID_VIEWER_ZOOMED_CLASS_NAME, MERMAID_VIEWER_ZOOM_VALUE_CLASS_NAME, MESSAGES, type MessageKey, type MessageVars, type Messages, NODE_LTS_VERSION, OPEN_PREVIEW_COMMAND, PROJECT_HOMEPAGE_URL, PROJECT_NAME, PlatformType, SCRIBDOWN_APP_CLASS_NAME, SCRIBDOWN_CONTENT_AREA_CLASS_NAME, SCRIBDOWN_CONTENT_SCROLL_CLASS_NAME, SCRIBDOWN_MARKDOWN_CLASS_NAME, SCRIBDOWN_PAGE_CLASS_NAME, SCRIBDOWN_THIN_SCROLLBAR_CLASS_NAME, SCRIBDOWN_TOC_HOST_CLASS_NAME, SCRIBDOWN_TOOLBAR_BTN_CLASS_NAME, SCRIBDOWN_TOOLBAR_CLASS_NAME, SCRIBDOWN_TOOLBAR_CURRENT_CLASS_NAME, SCRIBDOWN_TOOLBAR_CURRENT_TEXT_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_GROUP_CHOICES_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_GROUP_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_ITEM_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SELECT_CHEVRON_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SELECT_LABEL_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SELECT_VALUE_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SUB_ITEM_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SUB_ITEM_LABEL_CLASS_NAME, SCRIBDOWN_TOOLBAR_MENU_SUB_ITEM_MARK_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_CLOSE_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_EMPTY_CLASS_NAME, SCRIBDOWN_TOOLBAR_TOC_PANEL_TITLE_CLASS_NAME, SOURCE_LINE_ACTIVE_CLASS_NAME, SOURCE_LINE_DATA_ATTRIBUTE, SOURCE_LINE_OFFSCREEN_HINT_BOTTOM_CLASS_NAME, SOURCE_LINE_OFFSCREEN_HINT_CLASS_NAME, SOURCE_LINE_OFFSCREEN_HINT_TOP_CLASS_NAME, SUPPORTED_LOCALES, SUPPORTED_PLATFORMS, TOC_CLASS_NAME, TOC_ITEM_BRANCH_CLASS_NAME, TOC_ITEM_CLASS_PREFIX, TOC_ITEM_COLLAPSED_CLASS_NAME, TOC_LINK_ACTIVE_CLASS_NAME, TOC_LINK_CLASS_NAME, TOC_LIST_CLASS_NAME, TOC_LIST_NESTED_CLASS_NAME, TOC_NAV_CLASS_NAME, TOC_SUMMARY_CLASS_NAME, TOC_TOGGLE_CLASS_NAME, ThemeType, type Translator, VIDEO_ELEMENT_CLASS_NAME, VIDEO_FALLBACK_CLASS_NAME, VIDEO_FALLBACK_ICON_CLASS_NAME, VIDEO_FALLBACK_SOURCE_CLASS_NAME, VIDEO_FALLBACK_TEXT_CLASS_NAME, VIDEO_FIGURE_CLASS_NAME, VIDEO_FRAME_CLASS_NAME, VIDEO_FRAME_FAILED_CLASS_NAME, VIDEO_FRAME_LOADED_CLASS_NAME, VSCODE_NLS_SUFFIX, createTranslator, getActiveLocale, isLocalePreference, normalizeLocale, normalizeLocalePreference, resolveLocalePreference, setActiveLocale, setActiveLocaleFromHost, setActiveLocaleFromPreference, t };