@scribdown/shared 0.3.0 → 0.5.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/index.d.ts +255 -3
- package/dist/index.js +804 -14
- package/dist/index.js.map +1 -1
- package/package.json +1 -1
package/dist/index.d.ts
CHANGED
|
@@ -155,6 +155,18 @@ declare const VIDEO_FALLBACK_TEXT_CLASS_NAME = "scribdown-video-fallback-text";
|
|
|
155
155
|
* 视频失败态来源类名。
|
|
156
156
|
*/
|
|
157
157
|
declare const VIDEO_FALLBACK_SOURCE_CLASS_NAME = "scribdown-video-fallback-source";
|
|
158
|
+
/**
|
|
159
|
+
* 图片 / Mermaid 查看器共用按钮类名。
|
|
160
|
+
*/
|
|
161
|
+
declare const VIEWER_CONTROL_BUTTON_CLASS_NAME = "scribdown-viewer-control-button";
|
|
162
|
+
/**
|
|
163
|
+
* 图片 / Mermaid 查看器共用缩放按钮组类名。
|
|
164
|
+
*/
|
|
165
|
+
declare const VIEWER_ZOOM_GROUP_CLASS_NAME = "scribdown-viewer-zoom-group";
|
|
166
|
+
/**
|
|
167
|
+
* 图片 / Mermaid 查看器共用缩放比例类名。
|
|
168
|
+
*/
|
|
169
|
+
declare const VIEWER_ZOOM_VALUE_CLASS_NAME = "scribdown-viewer-zoom-value";
|
|
158
170
|
/**
|
|
159
171
|
* 图片查看器 dialog 类名。
|
|
160
172
|
*/
|
|
@@ -251,6 +263,22 @@ declare const CODE_BLOCK_GUTTER_CLASS_NAME = "scribdown-code-block__gutter";
|
|
|
251
263
|
* 代码块行号固定列中的单行节点类名。
|
|
252
264
|
*/
|
|
253
265
|
declare const CODE_BLOCK_GUTTER_LINE_CLASS_NAME = "scribdown-code-block__gutter-line";
|
|
266
|
+
/**
|
|
267
|
+
* Markdown 内容复制按钮类名。
|
|
268
|
+
*/
|
|
269
|
+
declare const CONTENT_COPY_BUTTON_CLASS_NAME = "scribdown-copy-button";
|
|
270
|
+
/**
|
|
271
|
+
* Markdown 内容复制按钮图标类名。
|
|
272
|
+
*/
|
|
273
|
+
declare const CONTENT_COPY_ICON_CLASS_NAME = "scribdown-copy-button__icon";
|
|
274
|
+
/**
|
|
275
|
+
* Markdown 内容复制按钮默认图标类名。
|
|
276
|
+
*/
|
|
277
|
+
declare const CONTENT_COPY_ICON_COPY_CLASS_NAME = "scribdown-copy-button__icon--copy";
|
|
278
|
+
/**
|
|
279
|
+
* Markdown 内容复制按钮成功图标类名。
|
|
280
|
+
*/
|
|
281
|
+
declare const CONTENT_COPY_ICON_CHECK_CLASS_NAME = "scribdown-copy-button__icon--check";
|
|
254
282
|
/**
|
|
255
283
|
* Mermaid 图表外层 figure 容器类名。
|
|
256
284
|
*/
|
|
@@ -303,6 +331,30 @@ declare const MERMAID_FIGURE_LOADED_CLASS_NAME = "scribdown-mermaid--loaded";
|
|
|
303
331
|
* Mermaid 全屏按钮类名（位于 figure 右下角）。
|
|
304
332
|
*/
|
|
305
333
|
declare const MERMAID_FULLSCREEN_BUTTON_CLASS_NAME = "scribdown-mermaid__fullscreen";
|
|
334
|
+
/**
|
|
335
|
+
* Mermaid 非全屏工具组类名。
|
|
336
|
+
*/
|
|
337
|
+
declare const MERMAID_CONTROLS_CLASS_NAME = "scribdown-mermaid__controls";
|
|
338
|
+
/**
|
|
339
|
+
* Mermaid 非全屏缩放按钮组类名。
|
|
340
|
+
*/
|
|
341
|
+
declare const MERMAID_ZOOM_GROUP_CLASS_NAME = "scribdown-mermaid__zoom-group";
|
|
342
|
+
/**
|
|
343
|
+
* Mermaid 非全屏工具按钮类名。
|
|
344
|
+
*/
|
|
345
|
+
declare const MERMAID_CONTROL_BUTTON_CLASS_NAME = "scribdown-mermaid__control-button";
|
|
346
|
+
/**
|
|
347
|
+
* Mermaid 非全屏缩放百分比类名。
|
|
348
|
+
*/
|
|
349
|
+
declare const MERMAID_ZOOM_VALUE_CLASS_NAME = "scribdown-mermaid__zoom-value";
|
|
350
|
+
/**
|
|
351
|
+
* Mermaid 非全屏拖拽模式类名。
|
|
352
|
+
*/
|
|
353
|
+
declare const MERMAID_DRAG_MODE_CLASS_NAME = "scribdown-mermaid--drag-mode";
|
|
354
|
+
/**
|
|
355
|
+
* Mermaid 非全屏拖拽中类名。
|
|
356
|
+
*/
|
|
357
|
+
declare const MERMAID_DRAGGING_CLASS_NAME = "scribdown-mermaid--dragging";
|
|
306
358
|
/**
|
|
307
359
|
* Mermaid 全屏查看器 dialog 类名。
|
|
308
360
|
*/
|
|
@@ -311,6 +363,10 @@ declare const MERMAID_VIEWER_DIALOG_CLASS_NAME = "scribdown-mermaid-viewer";
|
|
|
311
363
|
* Mermaid 全屏查看器缩放进行中状态类名。
|
|
312
364
|
*/
|
|
313
365
|
declare const MERMAID_VIEWER_ZOOMED_CLASS_NAME = "scribdown-mermaid-viewer--zoomed";
|
|
366
|
+
/**
|
|
367
|
+
* Mermaid 全屏查看器拖拽模式类名。
|
|
368
|
+
*/
|
|
369
|
+
declare const MERMAID_VIEWER_DRAG_MODE_CLASS_NAME = "scribdown-mermaid-viewer--drag-mode";
|
|
314
370
|
/**
|
|
315
371
|
* Mermaid 全屏查看器拖拽中状态类名。
|
|
316
372
|
*/
|
|
@@ -347,6 +403,14 @@ declare const MERMAID_VIEWER_CANVAS_CLASS_NAME = "scribdown-mermaid-viewer__canv
|
|
|
347
403
|
* Mermaid 全屏查看器缩放百分比文本类名。
|
|
348
404
|
*/
|
|
349
405
|
declare const MERMAID_VIEWER_ZOOM_VALUE_CLASS_NAME = "scribdown-mermaid-viewer__zoom-value";
|
|
406
|
+
/**
|
|
407
|
+
* 表格交互壳层类名。
|
|
408
|
+
*/
|
|
409
|
+
declare const TABLE_WRAPPER_CLASS_NAME = "scribdown-table";
|
|
410
|
+
/**
|
|
411
|
+
* 表格复制按钮修饰类名。
|
|
412
|
+
*/
|
|
413
|
+
declare const TABLE_COPY_BUTTON_CLASS_NAME = "scribdown-table__copy";
|
|
350
414
|
|
|
351
415
|
/**
|
|
352
416
|
* 平台类型枚举。
|
|
@@ -374,7 +438,7 @@ declare const PROJECT_HOMEPAGE_URL = "https://share-man-man.github.io/scribdown/
|
|
|
374
438
|
/**
|
|
375
439
|
* 当前项目固定 Node.js LTS 版本。
|
|
376
440
|
*/
|
|
377
|
-
declare const NODE_LTS_VERSION = "24.
|
|
441
|
+
declare const NODE_LTS_VERSION = "24.18.0";
|
|
378
442
|
/**
|
|
379
443
|
* 当前项目支持的平台列表。
|
|
380
444
|
*/
|
|
@@ -445,10 +509,33 @@ declare const SCRIBDOWN_TOOLBAR_TOC_PANEL_CLASS_NAME = "scribdown-toolbar-toc-pa
|
|
|
445
509
|
* 工具栏「当前章节指示器」class：位于目录按钮左侧，随滚动展示当前可视区所属标题。
|
|
446
510
|
*/
|
|
447
511
|
declare const SCRIBDOWN_TOOLBAR_CURRENT_CLASS_NAME = "scribdown-toolbar-current";
|
|
512
|
+
/**
|
|
513
|
+
* 强制暗色主题 class：加到文档根元素（`<html>`）上，优先级高于系统的
|
|
514
|
+
* `prefers-color-scheme`，供自带主题开关的宿主（文档站、VS Code）显式指定主题。
|
|
515
|
+
* 未加任何主题 class 时默认跟随系统偏好。
|
|
516
|
+
*/
|
|
517
|
+
declare const SCRIBDOWN_THEME_DARK_CLASS_NAME = "scribdown-theme-dark";
|
|
518
|
+
/**
|
|
519
|
+
* 强制浅色主题 class：与 {@link SCRIBDOWN_THEME_DARK_CLASS_NAME} 相对，
|
|
520
|
+
* 用于在系统处于暗色时仍把渲染结果锁定为浅色。
|
|
521
|
+
*/
|
|
522
|
+
declare const SCRIBDOWN_THEME_LIGHT_CLASS_NAME = "scribdown-theme-light";
|
|
448
523
|
/**
|
|
449
524
|
* 工具栏挂载时附加到 container 上的 class，把 container 标记为 TOC + 正文的 flex 容器。
|
|
450
525
|
*/
|
|
451
526
|
declare const SCRIBDOWN_TOC_HOST_CLASS_NAME = "scribdown-toc-host";
|
|
527
|
+
/**
|
|
528
|
+
* 目录侧栏与正文之间的拖拽调宽手柄 class（flex 流中位于 TOC 与正文之间的独立 item）。
|
|
529
|
+
*/
|
|
530
|
+
declare const SCRIBDOWN_TOC_RESIZER_CLASS_NAME = "scribdown-toc-resizer";
|
|
531
|
+
/**
|
|
532
|
+
* 拖拽调整目录宽度期间附加到 toc-host 上的 class，用于屏蔽正文文本选中并统一光标。
|
|
533
|
+
*/
|
|
534
|
+
declare const SCRIBDOWN_TOC_RESIZING_CLASS_NAME = "is-toc-resizing";
|
|
535
|
+
/**
|
|
536
|
+
* 目录侧栏宽度的 CSS 自定义属性名：声明在 toc-host 上，由 TOC 自身定宽与折叠位移共用。
|
|
537
|
+
*/
|
|
538
|
+
declare const TOC_WIDTH_CSS_VAR = "--scribdown-toc-width";
|
|
452
539
|
/**
|
|
453
540
|
* 工具栏挂载时用于包裹 container 已有内容的 wrapper class，作为 flex 流中的正文 item，与 TOC 横向并列。
|
|
454
541
|
* 自身 flex:1 填满 TOC 之外的剩余宽度，并作为内部滚动层的定位上下文（position:relative）。
|
|
@@ -524,6 +611,26 @@ declare const SCRIBDOWN_TOOLBAR_CURRENT_TEXT_CLASS_NAME = "scribdown-toolbar-cur
|
|
|
524
611
|
* localStorage 中保存页面内容宽度的 key。
|
|
525
612
|
*/
|
|
526
613
|
declare const CONTENT_WIDTH_STORAGE_KEY = "scribdown-content-width";
|
|
614
|
+
/**
|
|
615
|
+
* localStorage 中保存目录侧栏宽度（纯数字，单位 px）的 key。
|
|
616
|
+
*/
|
|
617
|
+
declare const TOC_WIDTH_STORAGE_KEY = "scribdown-toc-width";
|
|
618
|
+
/**
|
|
619
|
+
* 目录侧栏默认宽度（px），与 CSS 中 `min(280px, 70vw)` 的上限保持一致。
|
|
620
|
+
*/
|
|
621
|
+
declare const TOC_WIDTH_DEFAULT_PX = 280;
|
|
622
|
+
/**
|
|
623
|
+
* 目录侧栏可拖拽的最小宽度（px），低于此值目录条目已无法阅读。
|
|
624
|
+
*/
|
|
625
|
+
declare const TOC_WIDTH_MIN_PX = 180;
|
|
626
|
+
/**
|
|
627
|
+
* 目录侧栏可拖拽的最大宽度（px），另外还受「不超过宿主宽度 70%」约束。
|
|
628
|
+
*/
|
|
629
|
+
declare const TOC_WIDTH_MAX_PX = 640;
|
|
630
|
+
/**
|
|
631
|
+
* 目录侧栏宽度相对宿主容器宽度的占比上限，避免窄屏下目录挤没正文。
|
|
632
|
+
*/
|
|
633
|
+
declare const TOC_WIDTH_MAX_HOST_RATIO = 0.7;
|
|
527
634
|
|
|
528
635
|
/**
|
|
529
636
|
* Scribdown 国际化「语言」契约。
|
|
@@ -539,16 +646,71 @@ declare enum LocaleType {
|
|
|
539
646
|
/** 英语（默认兜底语言）。 */
|
|
540
647
|
English = "en",
|
|
541
648
|
/** 简体中文。 */
|
|
542
|
-
SimplifiedChinese = "zh-CN"
|
|
649
|
+
SimplifiedChinese = "zh-CN",
|
|
650
|
+
/** 繁体中文。 */
|
|
651
|
+
TraditionalChinese = "zh-TW",
|
|
652
|
+
/** 日语。 */
|
|
653
|
+
Japanese = "ja",
|
|
654
|
+
/** 韩语。 */
|
|
655
|
+
Korean = "ko",
|
|
656
|
+
/** 西班牙语。 */
|
|
657
|
+
Spanish = "es",
|
|
658
|
+
/** 法语。 */
|
|
659
|
+
French = "fr",
|
|
660
|
+
/** 德语。 */
|
|
661
|
+
German = "de",
|
|
662
|
+
/** 巴西葡萄牙语。 */
|
|
663
|
+
BrazilianPortuguese = "pt-BR",
|
|
664
|
+
/** 俄语。 */
|
|
665
|
+
Russian = "ru"
|
|
543
666
|
}
|
|
544
667
|
/**
|
|
545
668
|
* 默认兜底语言：无法识别宿主语言、或某语言缺失文案时最终回落到此。
|
|
546
669
|
*/
|
|
547
670
|
declare const DEFAULT_LOCALE: LocaleType;
|
|
671
|
+
/**
|
|
672
|
+
* 界面语言偏好。`System` 表示未显式选择语言，跟随浏览器或编辑器的系统界面语言。
|
|
673
|
+
* 宿主负责将该值持久化到自己的全局配置；共享层只负责解析，避免耦合 Web Storage。
|
|
674
|
+
*/
|
|
675
|
+
declare enum LocalePreference {
|
|
676
|
+
/** 跟随宿主系统界面语言。 */
|
|
677
|
+
System = "system",
|
|
678
|
+
/** 始终使用英语。 */
|
|
679
|
+
English = "en",
|
|
680
|
+
/** 始终使用简体中文。 */
|
|
681
|
+
SimplifiedChinese = "zh-CN",
|
|
682
|
+
/** 始终使用繁体中文。 */
|
|
683
|
+
TraditionalChinese = "zh-TW",
|
|
684
|
+
/** 始终使用日语。 */
|
|
685
|
+
Japanese = "ja",
|
|
686
|
+
/** 始终使用韩语。 */
|
|
687
|
+
Korean = "ko",
|
|
688
|
+
/** 始终使用西班牙语。 */
|
|
689
|
+
Spanish = "es",
|
|
690
|
+
/** 始终使用法语。 */
|
|
691
|
+
French = "fr",
|
|
692
|
+
/** 始终使用德语。 */
|
|
693
|
+
German = "de",
|
|
694
|
+
/** 始终使用巴西葡萄牙语。 */
|
|
695
|
+
BrazilianPortuguese = "pt-BR",
|
|
696
|
+
/** 始终使用俄语。 */
|
|
697
|
+
Russian = "ru"
|
|
698
|
+
}
|
|
548
699
|
/**
|
|
549
700
|
* 当前支持的全部语言列表（用于校验入参、遍历生成静态文件）。
|
|
550
701
|
*/
|
|
551
702
|
declare const SUPPORTED_LOCALES: LocaleType[];
|
|
703
|
+
/** 工具栏与宿主配置共用的可选语言定义。 */
|
|
704
|
+
interface LocalePreferenceOption {
|
|
705
|
+
/** 持久化到宿主配置的显式语言偏好。 */
|
|
706
|
+
preference: Exclude<LocalePreference, LocalePreference.System>;
|
|
707
|
+
/** 此偏好对应的实际界面语言。 */
|
|
708
|
+
locale: LocaleType;
|
|
709
|
+
/** 语言的原生自称，跨界面语言保持一致，便于识别和切换。 */
|
|
710
|
+
nativeLabel: string;
|
|
711
|
+
}
|
|
712
|
+
/** 语言选择器按稳定顺序展示的全部显式语言选项；跟随应用语言是未设置偏好的默认行为。 */
|
|
713
|
+
declare const LOCALE_PREFERENCE_OPTIONS: readonly LocalePreferenceOption[];
|
|
552
714
|
/**
|
|
553
715
|
* 各语言的回落链：命中语言缺失某 key 时，按顺序回落到链上语言，最终止于 {@link DEFAULT_LOCALE}。
|
|
554
716
|
* 默认语言自身链为空。
|
|
@@ -572,6 +734,18 @@ declare const VSCODE_NLS_SUFFIX: Record<LocaleType, string>;
|
|
|
572
734
|
* @returns 归一化后的受支持语言。
|
|
573
735
|
*/
|
|
574
736
|
declare function normalizeLocale(rawLocale: string | null | undefined): LocaleType;
|
|
737
|
+
/**
|
|
738
|
+
* 解析宿主保存的语言偏好。非法值安全回落到 {@link LocalePreference.System}。
|
|
739
|
+
* @param rawPreference 宿主配置或存储中读到的原始值。
|
|
740
|
+
* @returns 合法的语言偏好。
|
|
741
|
+
*/
|
|
742
|
+
declare function normalizeLocalePreference(rawPreference: unknown): LocalePreference;
|
|
743
|
+
/**
|
|
744
|
+
* 判断值是否为受支持的语言偏好。
|
|
745
|
+
* @param value 待校验的原始值。
|
|
746
|
+
* @returns 值为合法 {@link LocalePreference} 时返回 true。
|
|
747
|
+
*/
|
|
748
|
+
declare function isLocalePreference(value: unknown): value is LocalePreference;
|
|
575
749
|
|
|
576
750
|
/**
|
|
577
751
|
* Scribdown 文案目录的结构契约。
|
|
@@ -589,18 +763,48 @@ interface Messages {
|
|
|
589
763
|
"toolbar.tocClose": string;
|
|
590
764
|
/** 目录为空时的占位文案。 */
|
|
591
765
|
"toolbar.tocEmpty": string;
|
|
766
|
+
/** 目录侧栏右侧拖拽调宽手柄的 aria-label。 */
|
|
767
|
+
"toolbar.tocResize": string;
|
|
592
768
|
/** 工具栏「更多」按钮。 */
|
|
593
769
|
"toolbar.more": string;
|
|
594
770
|
/** 「更多」菜单内「页面宽度」触发行文案。 */
|
|
595
771
|
"toolbar.pageWidth": string;
|
|
596
772
|
/** 「更多」菜单内「回到顶部」项。 */
|
|
597
773
|
"toolbar.backTop": string;
|
|
774
|
+
/** 「更多」菜单内「语言」切换触发行。 */
|
|
775
|
+
"toolbar.language": string;
|
|
776
|
+
/** 语言切换列表中的跟随系统选项。 */
|
|
777
|
+
"toolbar.languageSystem": string;
|
|
778
|
+
/** 语言切换列表中的英文选项。 */
|
|
779
|
+
"toolbar.languageEnglish": string;
|
|
780
|
+
/** 语言切换列表中的简体中文选项。 */
|
|
781
|
+
"toolbar.languageSimplifiedChinese": string;
|
|
782
|
+
/** 语言切换列表中的繁体中文选项。 */
|
|
783
|
+
"toolbar.languageTraditionalChinese": string;
|
|
784
|
+
/** 语言切换列表中的日语选项。 */
|
|
785
|
+
"toolbar.languageJapanese": string;
|
|
786
|
+
/** 语言切换列表中的韩语选项。 */
|
|
787
|
+
"toolbar.languageKorean": string;
|
|
788
|
+
/** 语言切换列表中的西班牙语选项。 */
|
|
789
|
+
"toolbar.languageSpanish": string;
|
|
790
|
+
/** 语言切换列表中的法语选项。 */
|
|
791
|
+
"toolbar.languageFrench": string;
|
|
792
|
+
/** 语言切换列表中的德语选项。 */
|
|
793
|
+
"toolbar.languageGerman": string;
|
|
794
|
+
/** 语言切换列表中的巴西葡萄牙语选项。 */
|
|
795
|
+
"toolbar.languageBrazilianPortuguese": string;
|
|
796
|
+
/** 语言切换列表中的俄语选项。 */
|
|
797
|
+
"toolbar.languageRussian": string;
|
|
598
798
|
/** 「更多」菜单内「关于」项。 */
|
|
599
799
|
"toolbar.about": string;
|
|
600
800
|
/** 代码块复制按钮 aria-label（默认态）。 */
|
|
601
801
|
"code.copy": string;
|
|
602
802
|
/** 代码块复制按钮 aria-label（已复制态）。 */
|
|
603
803
|
"code.copied": string;
|
|
804
|
+
/** 通用内容复制按钮 aria-label。 */
|
|
805
|
+
"content.copy": string;
|
|
806
|
+
/** 通用内容复制成功态 aria-label。 */
|
|
807
|
+
"content.copied": string;
|
|
604
808
|
/** Mermaid 渲染失败占位文案。 */
|
|
605
809
|
"mermaid.renderFailed": string;
|
|
606
810
|
/** Mermaid 代码块上的「全屏查看」按钮 aria-label。 */
|
|
@@ -613,8 +817,16 @@ interface Messages {
|
|
|
613
817
|
"mermaid.zoomOut": string;
|
|
614
818
|
/** Mermaid 全屏查看器重置缩放按钮 aria-label。 */
|
|
615
819
|
"mermaid.zoomReset": string;
|
|
820
|
+
/** Mermaid 非全屏缩放按钮组 aria-label。 */
|
|
821
|
+
"mermaid.zoomControls": string;
|
|
822
|
+
/** Mermaid 非全屏切换到拖拽模式按钮 aria-label。 */
|
|
823
|
+
"mermaid.switchToDrag": string;
|
|
824
|
+
/** Mermaid 非全屏切换到选择模式按钮 aria-label。 */
|
|
825
|
+
"mermaid.switchToSelect": string;
|
|
616
826
|
/** Mermaid 全屏查看器关闭按钮 aria-label。 */
|
|
617
827
|
"mermaid.close": string;
|
|
828
|
+
/** 表格复制按钮 aria-label。 */
|
|
829
|
+
"table.copy": string;
|
|
618
830
|
/** 图片查看器无标题时的兜底 aria-label。 */
|
|
619
831
|
"image.viewFull": string;
|
|
620
832
|
/** 图片查看器带标题时的 aria-label（插值：{alt} 图片标题）。 */
|
|
@@ -629,6 +841,8 @@ interface Messages {
|
|
|
629
841
|
"image.zoomOut": string;
|
|
630
842
|
/** 图片查看器重置缩放按钮 aria-label。 */
|
|
631
843
|
"image.zoomReset": string;
|
|
844
|
+
/** 图片查看器缩放按钮组 aria-label。 */
|
|
845
|
+
"image.zoomControls": string;
|
|
632
846
|
/** 图片查看器关闭按钮 aria-label。 */
|
|
633
847
|
"image.close": string;
|
|
634
848
|
/** 视频加载失败占位文案。 */
|
|
@@ -717,6 +931,30 @@ interface Messages {
|
|
|
717
931
|
"manifest.vscodeDescription": string;
|
|
718
932
|
/** VS Code「打开预览」命令标题。 */
|
|
719
933
|
"manifest.vscodeCommandTitle": string;
|
|
934
|
+
/** VS Code 界面语言设置的说明。 */
|
|
935
|
+
"manifest.vscodeLanguageDescription": string;
|
|
936
|
+
/** VS Code 界面语言设置中「跟随系统」选项的说明。 */
|
|
937
|
+
"manifest.vscodeLanguageSystemDescription": string;
|
|
938
|
+
/** VS Code 界面语言设置中英语选项的说明。 */
|
|
939
|
+
"manifest.vscodeLanguageEnglishDescription": string;
|
|
940
|
+
/** VS Code 界面语言设置中简体中文选项的说明。 */
|
|
941
|
+
"manifest.vscodeLanguageSimplifiedChineseDescription": string;
|
|
942
|
+
/** VS Code 界面语言设置中繁体中文选项的说明。 */
|
|
943
|
+
"manifest.vscodeLanguageTraditionalChineseDescription": string;
|
|
944
|
+
/** VS Code 界面语言设置中日语选项的说明。 */
|
|
945
|
+
"manifest.vscodeLanguageJapaneseDescription": string;
|
|
946
|
+
/** VS Code 界面语言设置中韩语选项的说明。 */
|
|
947
|
+
"manifest.vscodeLanguageKoreanDescription": string;
|
|
948
|
+
/** VS Code 界面语言设置中西班牙语选项的说明。 */
|
|
949
|
+
"manifest.vscodeLanguageSpanishDescription": string;
|
|
950
|
+
/** VS Code 界面语言设置中法语选项的说明。 */
|
|
951
|
+
"manifest.vscodeLanguageFrenchDescription": string;
|
|
952
|
+
/** VS Code 界面语言设置中德语选项的说明。 */
|
|
953
|
+
"manifest.vscodeLanguageGermanDescription": string;
|
|
954
|
+
/** VS Code 界面语言设置中巴西葡萄牙语选项的说明。 */
|
|
955
|
+
"manifest.vscodeLanguageBrazilianPortugueseDescription": string;
|
|
956
|
+
/** VS Code 界面语言设置中俄语选项的说明。 */
|
|
957
|
+
"manifest.vscodeLanguageRussianDescription": string;
|
|
720
958
|
}
|
|
721
959
|
/**
|
|
722
960
|
* 文案 key 联合类型，供 `t()` 与 `createTranslator()` 约束调用方只能取已声明的 key。
|
|
@@ -756,6 +994,20 @@ declare function setActiveLocale(locale: LocaleType): void;
|
|
|
756
994
|
* @returns 当前语言。
|
|
757
995
|
*/
|
|
758
996
|
declare function getActiveLocale(): LocaleType;
|
|
997
|
+
/**
|
|
998
|
+
* 按「显式语言偏好优先，系统语言其次」解析当前应使用的语言。
|
|
999
|
+
* @param preference 宿主持久化的语言偏好；省略时视为跟随系统。
|
|
1000
|
+
* @param rawHostLocale 宿主原始语言标签（如 `navigator.language`、`vscode.env.language`）。
|
|
1001
|
+
* @returns 实际应生效的受支持语言。
|
|
1002
|
+
*/
|
|
1003
|
+
declare function resolveLocalePreference(preference: LocalePreference | undefined, rawHostLocale: string | null | undefined): LocaleType;
|
|
1004
|
+
/**
|
|
1005
|
+
* 根据宿主保存的偏好和系统语言更新全局界面语言。
|
|
1006
|
+
* @param preference 宿主持久化的语言偏好；省略时跟随系统。
|
|
1007
|
+
* @param rawHostLocale 宿主原始语言标签。
|
|
1008
|
+
* @returns 实际生效的语言。
|
|
1009
|
+
*/
|
|
1010
|
+
declare function setActiveLocaleFromPreference(preference: LocalePreference | undefined, rawHostLocale: string | null | undefined): LocaleType;
|
|
759
1011
|
/**
|
|
760
1012
|
* 便捷方法：把宿主原始语言标签归一化后设为全局语言。
|
|
761
1013
|
* @param rawLocale 宿主原始语言标签（如 `navigator.language`、`vscode.env.language`）。
|
|
@@ -781,4 +1033,4 @@ type Translator = (key: MessageKey, vars?: MessageVars) => string;
|
|
|
781
1033
|
*/
|
|
782
1034
|
declare function createTranslator(locale: LocaleType | string): Translator;
|
|
783
1035
|
|
|
784
|
-
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, 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, normalizeLocale, setActiveLocale, setActiveLocaleFromHost, t };
|
|
1036
|
+
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_COPY_BUTTON_CLASS_NAME, CONTENT_COPY_ICON_CHECK_CLASS_NAME, CONTENT_COPY_ICON_CLASS_NAME, CONTENT_COPY_ICON_COPY_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_CONTROLS_CLASS_NAME, MERMAID_CONTROL_BUTTON_CLASS_NAME, MERMAID_DRAGGING_CLASS_NAME, MERMAID_DRAG_MODE_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_DRAG_MODE_CLASS_NAME, MERMAID_VIEWER_VIEWPORT_CLASS_NAME, MERMAID_VIEWER_ZOOMED_CLASS_NAME, MERMAID_VIEWER_ZOOM_VALUE_CLASS_NAME, MERMAID_ZOOM_GROUP_CLASS_NAME, MERMAID_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_THEME_DARK_CLASS_NAME, SCRIBDOWN_THEME_LIGHT_CLASS_NAME, SCRIBDOWN_THIN_SCROLLBAR_CLASS_NAME, SCRIBDOWN_TOC_HOST_CLASS_NAME, SCRIBDOWN_TOC_RESIZER_CLASS_NAME, SCRIBDOWN_TOC_RESIZING_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, TABLE_COPY_BUTTON_CLASS_NAME, TABLE_WRAPPER_CLASS_NAME, 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, TOC_WIDTH_CSS_VAR, TOC_WIDTH_DEFAULT_PX, TOC_WIDTH_MAX_HOST_RATIO, TOC_WIDTH_MAX_PX, TOC_WIDTH_MIN_PX, TOC_WIDTH_STORAGE_KEY, 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, VIEWER_CONTROL_BUTTON_CLASS_NAME, VIEWER_ZOOM_GROUP_CLASS_NAME, VIEWER_ZOOM_VALUE_CLASS_NAME, VSCODE_NLS_SUFFIX, createTranslator, getActiveLocale, isLocalePreference, normalizeLocale, normalizeLocalePreference, resolveLocalePreference, setActiveLocale, setActiveLocaleFromHost, setActiveLocaleFromPreference, t };
|