@gct-paas/word 0.1.21 → 0.1.23

package/dist/core/view/utils/TextUtil.d.ts

@@ -8,6 +8,17 @@ export declare class TextUtil {
     private static readonly EAST_ASIAN_FULL_WIDTH_REGEX;
     /** 表单/文档中常见的几何符号 */
     private static readonly FULL_WIDTH_SYMBOL_REGEX;
+    /**
+     * 视觉间距系数
+     * 值 = fontSize * ratio
+     *
+     * 解决：
+     * - N·m
+     * - N/A
+     * - kg·m²
+     * 等符号贴太近的问题
+     */
+    private static readonly VISUAL_SPACING_MAP;
     private static fontMetricsCache;
     private static layoutSizeCache;
     /**
@@ -22,6 +33,25 @@ export declare class TextUtil {
      * @returns
      */
     static isFullWidthChar(char: string): boolean;
+    /**
+     * 获取字符视觉间距
+     *
+     * 注意：
+     * 这里不是 glyph width
+     * 而是用于排版推进的额外 advance width
+     *
+     * 例如：
+     * - N·m
+     * - N/A
+     *
+     * 中间符号真实宽度很小，
+     * 但视觉上需要 breathing space
+     *
+     * @param char
+     * @param fontSize
+     * @returns
+     */
+    static getVisualSpacing(char: string, fontSize: number): number;
     /**
      * 生成文本度量缓存键
      * @param payload
@@ -30,9 +60,9 @@ export declare class TextUtil {
      */
     private static getMeasureCacheKey;
     /**
-     * 计算度量 - 基于 JSON 序列化的缓存（LRU）
-     * 将最终的 config 序列化为缓存键，相同配置直接返回缓存结果
-     * 最近使用的项会被移到末尾，超限时删除最古老的项
+     * 计算字体度量
+     * ascent / descent
+     *
      * @param payload
      * @returns
      */
@@ -41,7 +71,31 @@ export declare class TextUtil {
         descent: number;
     };
     /**
-     * 计算单个字符布局大小 - 基于 JSON 序列化的缓存（LRU）
+     * 获取字符排版推进宽度
+     *
+     * 注意：
+     * 这里返回的是：
+     * advance width
+     *
+     * 而不是：
+     * glyph width
+     *
+     * 用于：
+     * - 自动换行
+     * - 光标推进
+     * - 文本布局
+     * - selection
+     *
+     * @param payload
+     * @returns
+     */
+    static getAdvanceWidth(payload: Konva.TextConfig): number;
+    /**
+     * 计算单字符布局大小
+     *
+     * 注意：
+     * width 使用 advance width
+     *
      * @param payload
      * @returns
      */
@@ -50,12 +104,12 @@ export declare class TextUtil {
         height: number;
     };
     /**
-     * 清除度量结果缓存
+     * 清除度量缓存
      */
     static clearMeasureCache(): void;
     /**
-     * 获取缓存大小信息
-     * @returns 返回测量缓存的大小 {fontMetrics, layoutSize}
+     * 获取缓存大小
+     * @returns
      */
     static getMeasureCacheSize(): {
         fontMetrics: number;