@pixui-dev/pixui-richtext-helper 0.1.1-beta.2 → 0.1.1-beta.3

package/dist/RichText.d.ts

@@ -0,0 +1,22 @@
+import { RichText_Refactor, LinkNodeType, LinkClickParams } from "./richtext/RichText_Refactor";
+/**
+ * 对外暴露的 RichText 组件。
+ * 保持旧版使用方式不变，内部委托给 RichText_Refactor 实现。
+ */
+export declare const RichText: {
+    /** 链接节点类型枚举 */
+    LinkNodeType: typeof LinkNodeType;
+    /**
+     * 将富文本转换为 PixUI innerHTML 兼容格式
+     * @see RichText_Refactor.convertRichTextToPixuiStyle
+     */
+    convertRichTextToPixuiStyle: typeof RichText_Refactor.convertRichTextToPixuiStyle;
+    /**
+     * 绑定富文本中的链接点击事件
+     * @see RichText_Refactor.bindLinkClickEvents
+     */
+    bindLinkClickEvents: typeof RichText_Refactor.bindLinkClickEvents;
+};
+export type { LinkClickParams };
+export { LinkNodeType };
+export default RichText;

package/dist/RichText.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LinkNodeType = exports.RichText = void 0;
+var RichText_Refactor_1 = require("./richtext/RichText_Refactor");
+Object.defineProperty(exports, "LinkNodeType", { enumerable: true, get: function () { return RichText_Refactor_1.LinkNodeType; } });
+/**
+ * 对外暴露的 RichText 组件。
+ * 保持旧版使用方式不变，内部委托给 RichText_Refactor 实现。
+ */
+exports.RichText = {
+    /** 链接节点类型枚举 */
+    LinkNodeType: RichText_Refactor_1.LinkNodeType,
+    /**
+     * 将富文本转换为 PixUI innerHTML 兼容格式
+     * @see RichText_Refactor.convertRichTextToPixuiStyle
+     */
+    convertRichTextToPixuiStyle: RichText_Refactor_1.RichText_Refactor.convertRichTextToPixuiStyle,
+    /**
+     * 绑定富文本中的链接点击事件
+     * @see RichText_Refactor.bindLinkClickEvents
+     */
+    bindLinkClickEvents: RichText_Refactor_1.RichText_Refactor.bindLinkClickEvents,
+};
+exports.default = exports.RichText;

package/dist/RichTextUtils.d.ts

@@ -1,3 +1,9 @@
+/**
+ * pixui富文本转换工具
+ * 将管理端下发的富文本转换成pixui的innerHtml可以使用的格式，被转换的富文本只应该包括文本和图片及相关的样式。
+ * 将富文本内容转换为：
+ * 段落div/h节点（不带样式，用来形成一个段落） -> text（只带text节点样式，pixui的段落需要在text节点下才能表现正常）->  <div>（带有文本的样式） 文本1 </div> <div>（带有文本的样式） 文本2 </div> <img>（带有图片的样式） 图片1 </img> <div>（带有文本的样式） 文本3 </div> (每个子div带有这一小段文本/图片的样式，这一段所有text节点下的div/img会被text节点正确的换行排列)
+ */
 export declare namespace RichText {
     /**
      * 富文本中的超链接节点类型

package/dist/RichTextUtils.js

@@ -44,6 +44,12 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.RichText = void 0;
 var cheerio = __importStar(require("cheerio"));
+/**
+ * pixui富文本转换工具
+ * 将管理端下发的富文本转换成pixui的innerHtml可以使用的格式，被转换的富文本只应该包括文本和图片及相关的样式。
+ * 将富文本内容转换为：
+ * 段落div/h节点（不带样式，用来形成一个段落） -> text（只带text节点样式，pixui的段落需要在text节点下才能表现正常）->  <div>（带有文本的样式） 文本1 </div> <div>（带有文本的样式） 文本2 </div> <img>（带有图片的样式） 图片1 </img> <div>（带有文本的样式） 文本3 </div> (每个子div带有这一小段文本/图片的样式，这一段所有text节点下的div/img会被text节点正确的换行排列)
+ */
 var RichText;
 (function (RichText) {
     /**
@@ -246,7 +252,7 @@ var RichText;
                     });
                 }
                 // 转换为简单div，样式已合并
-                $(this).replaceWith("<div style=\"".concat(finalStyle, "\" id=\"").concat(id, "\" class=\"PA_RichTextHref_ATag\" data-href=\"").concat(href, "\">").concat(textContent, "</div>"));
+                $(this).replaceWith("<div style=\"".concat(finalStyle, "\" id=\"").concat(id, "\" class=\"PA_RichTextHref_ATag\" >").concat(textContent, "</div>"));
             });
             //找到所有的文字节点，外层包裹text标签
             $("*").each(function () {

package/dist/index.d.ts

@@ -1,2 +1,2 @@
-export { RichText } from "./RichTextUtils";
-export { RichText as default } from "./RichTextUtils";
+export { RichText } from "./RichText";
+export { RichText as default } from "./RichText";

package/dist/index.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.default = exports.RichText = void 0;
-var RichTextUtils_1 = require("./RichTextUtils");
-Object.defineProperty(exports, "RichText", { enumerable: true, get: function () { return RichTextUtils_1.RichText; } });
-var RichTextUtils_2 = require("./RichTextUtils");
-Object.defineProperty(exports, "default", { enumerable: true, get: function () { return RichTextUtils_2.RichText; } });
+var RichText_1 = require("./RichText");
+Object.defineProperty(exports, "RichText", { enumerable: true, get: function () { return RichText_1.RichText; } });
+var RichText_2 = require("./RichText");
+Object.defineProperty(exports, "default", { enumerable: true, get: function () { return RichText_2.RichText; } });

package/dist/richtext/RichText_Refactor.d.ts

@@ -0,0 +1,77 @@
+/*****************************************************
+ *  类型、枚举定义
+ *****************************************************/
+/** 链接节点的类型 */
+export declare enum LinkNodeType {
+    IMG = "img",
+    DIV = "div"
+}
+/** 点击回调参数 */
+export interface LinkClickParams {
+    type: LinkNodeType;
+    href: string;
+    id: string;
+}
+/*****************************************************
+ *  RichText_Refactor 主类
+ *****************************************************/
+export declare class RichText_Refactor {
+    private static linkNodes;
+    private static hrefIdCnt;
+    /**
+     * 富文本转换为 PixUI innerHTML 兼容格式
+     * @param str 原始富文本 HTML
+     * @param config 可选配置
+     */
+    static convertRichTextToPixuiStyle(str: string, config?: {
+        lineHeightScale?: number;
+    }): string;
+    /**
+     * 绑定链接点击事件
+     */
+    static bindLinkClickEvents(linkClickHandler: (params: LinkClickParams) => void): void;
+    /*****************************************************
+     *  内部流程函数
+     *****************************************************/
+    /**
+     * 将 HTML 切分为基础段落片段。
+     * 简易实现：以顶级节点为粒度切分，再根据最外层列表节点进行分割。
+     */
+    private static splitIntoSegments;
+    /**
+     * 处理单个段落片段，返回转换后的片段 HTML
+     */
+    private static processSegment;
+    private static handleIndentClass;
+    private static fixImgSizeUnit;
+    /** 列表处理（将 ol/ul/li 替换为 div 结构） */
+    private static handleLists;
+    /** 将连续 <br> 替换为透明占位文字，确保 PixUI 换行 */
+    private static replaceBrWithPlaceholder;
+    /** 处理 <a> 标签：转为 div、保留样式、记录链接 */
+    private static handleAnchorTag;
+    /** 用 text 标签包裹纯文本节点 */
+    private static wrapTextNodes;
+    /** strong / em / u / s / span 等标签替换成 text */
+    private static replaceStyleTags;
+    /** p → div */
+    private static replacePTag;
+    /** img 的 href 转移处理 & 记录链接 */
+    private static handleImgHref;
+    /** 给指定标签补 flex-shrink:0 */
+    private static addFlexShrink;
+    /** 把嵌套的 text 展平 */
+    private static flattenNestedText;
+    /** 将同一行的 text 节点转为 div 并外包一层 text */
+    private static convertSiblingTextToDiv;
+    /** text-indent 首行缩进处理 */
+    private static handleTextIndent;
+    /** line-height / letter-spacing 调整 */
+    private static adjustLineHeightAndLetterSpacing;
+    /** 把 div 的 text-align 转移到子 text 上 */
+    private static transferTextAlign;
+    /** 删除空 text 节点 */
+    private static removeEmptyText;
+    /** 补默认 heading 字体大小 */
+    private static fixHeadingFontSize;
+}

package/dist/richtext/RichText_Refactor.js

@@ -0,0 +1,637 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RichText_Refactor = exports.LinkNodeType = void 0;
+var cheerio = __importStar(require("cheerio"));
+/*****************************************************
+ *  类型、枚举定义
+ *****************************************************/
+/** 链接节点的类型 */
+var LinkNodeType;
+(function (LinkNodeType) {
+    LinkNodeType["IMG"] = "img";
+    LinkNodeType["DIV"] = "div";
+})(LinkNodeType || (exports.LinkNodeType = LinkNodeType = {}));
+/*****************************************************
+ *  工具函数
+ *****************************************************/
+/**
+ * 解析 style 字符串为对象
+ */
+var parseStyleString = function (styleStr) {
+    var result = {};
+    if (!styleStr || !styleStr.trim())
+        return result;
+    // 分割多个样式声明
+    var declarations = styleStr.split(";").filter(function (decl) { return decl.trim(); });
+    declarations.forEach(function (decl) {
+        var colonIndex = decl.indexOf(":");
+        if (colonIndex > 0) {
+            var property = decl.substring(0, colonIndex).trim();
+            var value = decl.substring(colonIndex + 1).trim();
+            if (property && value) {
+                result[property] = value;
+            }
+        }
+    });
+    return result;
+};
+/**
+ * 将样式对象序列化为字符串
+ */
+var serializeStyleObject = function (styleObj) {
+    return (Object.entries(styleObj)
+        .map(function (_a) {
+        var property = _a[0], value = _a[1];
+        return "".concat(property, ": ").concat(value);
+    })
+        .join("; ") + (Object.keys(styleObj).length > 0 ? ";" : ""));
+};
+/**
+ * 合并多个 style 字符串，自动处理分号与空格，后合并的覆盖前面的（符合CSS优先级规则）
+ */
+var mergeStyles = function () {
+    var styles = [];
+    for (var _i = 0; _i < arguments.length; _i++) {
+        styles[_i] = arguments[_i];
+    }
+    var mergedStyleObj = {};
+    // 过滤空值并解析每个样式字符串
+    var validStyles = styles.filter(function (s) { return !!s && s.trim().length > 0; });
+    // 按顺序合并，后面的覆盖前面的
+    validStyles.forEach(function (styleStr) {
+        var styleObj = parseStyleString(styleStr);
+        Object.assign(mergedStyleObj, styleObj);
+    });
+    return serializeStyleObject(mergedStyleObj);
+};
+/*****************************************************
+ *  RichText_Refactor 主类
+ *****************************************************/
+var RichText_Refactor = /** @class */ (function () {
+    function RichText_Refactor() {
+    }
+    /**
+     * 富文本转换为 PixUI innerHTML 兼容格式
+     * @param str 原始富文本 HTML
+     * @param config 可选配置
+     */
+    RichText_Refactor.convertRichTextToPixuiStyle = function (str, config) {
+        // 重置全局状态
+        RichText_Refactor.linkNodes = [];
+        RichText_Refactor.hrefIdCnt = 0;
+        // ---------- 第 1 步：段落分割（基础实现：根节点切分） ----------
+        var segments = RichText_Refactor.splitIntoSegments(str);
+        // ---------- 第 2/3 步：遍历 + 展平 ----------
+        // 为保证兼容性，我们直接对 HTML 进行逐段处理并在内部构建 PixUI 结构。
+        // 这样既保持分段概念，又可复用旧逻辑的稳定性。
+        var processedSegments = segments.map(function (seg) { return RichText_Refactor.processSegment(seg, config); });
+        // ---------- 第 4 步：拼装 ----------
+        var Result = processedSegments.join("");
+        console.log(Result);
+        return Result;
+    };
+    /**
+     * 绑定链接点击事件
+     */
+    RichText_Refactor.bindLinkClickEvents = function (linkClickHandler) {
+        RichText_Refactor.linkNodes.forEach(function (nodeInfo) {
+            var element = document.getElementById(nodeInfo.id);
+            if (element) {
+                element.onclick = function (e) {
+                    e.stopPropagation();
+                    e.preventDefault();
+                    linkClickHandler({
+                        type: nodeInfo.type,
+                        href: nodeInfo.href,
+                        id: nodeInfo.id,
+                    });
+                    return false;
+                };
+            }
+        });
+    };
+    /*****************************************************
+     *  内部流程函数
+     *****************************************************/
+    /**
+     * 将 HTML 切分为基础段落片段。
+     * 简易实现：以顶级节点为粒度切分，再根据最外层列表节点进行分割。
+     */
+    RichText_Refactor.splitIntoSegments = function (html) {
+        var $ = cheerio.load(html, null, false);
+        var segments = [];
+        // 如果有 body，取其直接子节点；否则取根节点下的直接子节点
+        var roots = $("body").length > 0 ? $("body").children() : $.root().children();
+        roots.each(function () {
+            var nodeHtml = $(this).toString();
+            // 切分包含最外层列表的片段
+            if (/^<\s*(ol|ul)/i.test(nodeHtml)) {
+                segments.push(nodeHtml);
+            }
+            else {
+                // 进一步检查内部是否存在最外层的 ol/ul，需要分成 前段 + 列表 + 后段
+                var inner$_1 = cheerio.load(nodeHtml, null, false);
+                var outerLists_1 = [];
+                inner$_1("ol, ul").each(function () {
+                    if (inner$_1(this).parents("ol, ul").length === 0) {
+                        outerLists_1.push(inner$_1(this).toString());
+                    }
+                });
+                if (outerLists_1.length === 0) {
+                    segments.push(nodeHtml);
+                }
+                else {
+                    var tempHtml_1 = nodeHtml;
+                    outerLists_1.forEach(function (listHtml) {
+                        var idx = tempHtml_1.indexOf(listHtml);
+                        if (idx >= 0) {
+                            var before = tempHtml_1.substring(0, idx);
+                            if (before.trim())
+                                segments.push(before);
+                            segments.push(listHtml);
+                            tempHtml_1 = tempHtml_1.substring(idx + listHtml.length);
+                        }
+                    });
+                    if (tempHtml_1.trim())
+                        segments.push(tempHtml_1);
+                }
+            }
+        });
+        // fallback：原样返回
+        if (segments.length === 0)
+            segments.push(html);
+        return segments;
+    };
+    /**
+     * 处理单个段落片段，返回转换后的片段 HTML
+     */
+    RichText_Refactor.processSegment = function (segmentHtml, config) {
+        var $ = cheerio.load(segmentHtml, null, false);
+        // 按旧实现顺序进行处理，但重构为独立函数划分
+        this.handleIndentClass($);
+        this.fixImgSizeUnit($);
+        this.handleLists($);
+        this.replaceBrWithPlaceholder($);
+        this.handleAnchorTag($);
+        this.wrapTextNodes($);
+        this.replaceStyleTags($);
+        this.replacePTag($);
+        this.handleImgHref($);
+        this.addFlexShrink($);
+        this.flattenNestedText($);
+        this.convertSiblingTextToDiv($);
+        this.handleTextIndent($);
+        this.adjustLineHeightAndLetterSpacing($, config);
+        this.transferTextAlign($);
+        this.removeEmptyText($);
+        this.fixHeadingFontSize($);
+        // 最后：修正 img 结束标签、nbsp
+        var res = $.html();
+        res = res.replaceAll(/<img([^>]+)>/g, "<img$1 />").replaceAll(/&nbsp;/g, " ");
+        return res;
+    };
+    // ------------------------------
+    // 各独立处理步骤实现
+    // ------------------------------
+    RichText_Refactor.handleIndentClass = function ($) {
+        var _loop_1 = function (i) {
+            var indent = "ql-indent-".concat(i);
+            var extStyle = "padding-left: ".concat(i * 2, "rem");
+            $(".".concat(indent)).each(function () {
+                var ori = $(this).attr("style") || "";
+                $(this).attr("style", mergeStyles(ori, extStyle));
+                $(this).removeClass(indent);
+            });
+        };
+        for (var i = 1; i <= 10; i++) {
+            _loop_1(i);
+        }
+    };
+    RichText_Refactor.fixImgSizeUnit = function ($) {
+        $("img").each(function () {
+            var width = $(this).attr("width");
+            var height = $(this).attr("height");
+            if (width && width + "" === parseInt(width) + "") {
+                $(this).attr("width", "".concat(width, "px"));
+            }
+            if (height && height + "" === parseInt(height) + "") {
+                $(this).attr("height", "".concat(height, "px"));
+            }
+        });
+    };
+    /** 列表处理（将 ol/ul/li 替换为 div 结构） */
+    RichText_Refactor.handleLists = function ($) {
+        var topLevelLists = [];
+        var collectListItems = function ($container, currentLevel) {
+            if (currentLevel === void 0) { currentLevel = 0; }
+            var items = [];
+            $container.children().each(function () {
+                var $child = $(this);
+                if ($child.is("li")) {
+                    var isOrdered = $child.parent().is("ol");
+                    var orderIndex = 1;
+                    if (isOrdered) {
+                        orderIndex = $child.prevAll("li").length + 1;
+                    }
+                    var marker = isOrdered ? "".concat(orderIndex, ".") : "•";
+                    var paddingLeft = currentLevel * 2; // 每层缩进 2rem
+                    var $liClone = $child.clone();
+                    $liClone.find("ol, ul").remove();
+                    var textContent = $liClone.text().trim() || "";
+                    var style = $child.attr("style") || "";
+                    items.push({
+                        level: currentLevel,
+                        isOrdered: isOrdered,
+                        orderIndex: orderIndex,
+                        marker: marker,
+                        paddingLeft: paddingLeft,
+                        textContent: textContent,
+                        style: style,
+                    });
+                    // 处理子列表
+                    $child.find("ol, ul").each(function () {
+                        var $nestedList = $(this);
+                        if ($nestedList.parent().closest("li")[0] === $child[0]) {
+                            var childItems = collectListItems($nestedList, currentLevel + 1);
+                            items.push.apply(items, childItems);
+                        }
+                    });
+                }
+            });
+            return items;
+        };
+        // 找到所有顶层列表
+        $("ol, ul").each(function () {
+            var $list = $(this);
+            if ($list.parents("ol, ul").length === 0) {
+                var placeholder = $("<div data-list-placeholder=\"true\"></div>");
+                $list.before(placeholder);
+                var items = collectListItems($list, 1);
+                topLevelLists.push({
+                    element: $list,
+                    placeholder: placeholder,
+                    items: items,
+                });
+            }
+        });
+        // 移除原列表结构
+        $("ol, ul, li").remove();
+        // 插入新列表
+        topLevelLists.forEach(function (listInfo) {
+            var placeholder = listInfo.placeholder, items = listInfo.items;
+            var html = items
+                .map(function (it) {
+                return ("<div style=\"".concat(mergeStyles(it.style, "padding-left: ".concat(it.paddingLeft, "rem"), "flex-shrink: 0", "width: 100%", "flex-direction: row", "display: flex"), "\" data-list-item=\"true\">") +
+                    "<text style=\"".concat(mergeStyles("flex-shrink: 0", "width: 100%", "line-height: 1", "display: flex", "flex-direction: row"), "\">") +
+                    "<div style=\"".concat(mergeStyles("word-break: break-word", "flex-shrink: 0", "margin-right: 0.5rem"), "\">").concat(it.marker, "</div>") +
+                    "<div style=\"".concat(mergeStyles("word-break: break-word", "flex-shrink: 0", "flex: 1"), "\">").concat(it.textContent, "</div>") +
+                    "</text></div>");
+            })
+                .join("");
+            placeholder.after(html);
+            placeholder.remove();
+        });
+    };
+    /** 将连续 <br> 替换为透明占位文字，确保 PixUI 换行 */
+    RichText_Refactor.replaceBrWithPlaceholder = function ($) {
+        $("br").each(function () {
+            $(this).replaceWith("<span style=\"".concat(mergeStyles("color: transparent", "flex-shrink: 0", "font-size: 20px"), "\" class='pixui-richtext-br-placeholder'>1</span>"));
+        });
+    };
+    /** 处理 <a> 标签：转为 div、保留样式、记录链接 */
+    RichText_Refactor.handleAnchorTag = function ($) {
+        var self = this;
+        $("a").each(function () {
+            var id = "PA_RichTextHrefId_".concat(self.hrefIdCnt++);
+            var href = $(this).attr("href");
+            var originalStyle = $(this).attr("style") || "";
+            var textContent = $(this).text();
+            var mergedStyles = [];
+            // 收集子元素的样式
+            if ($(this).find("strong").length > 0)
+                mergedStyles.push("font-weight: bold;");
+            if ($(this).find("em").length > 0)
+                mergedStyles.push("font-style: italic;");
+            if ($(this).find("u").length > 0)
+                mergedStyles.push("text-decoration: underline;");
+            if ($(this).find("s").length > 0)
+                mergedStyles.push("text-decoration: line-through;");
+            $(this)
+                .find("strong, em, u, s, span")
+                .each(function () {
+                var innerStyle = $(this).attr("style");
+                if (innerStyle)
+                    mergedStyles.push(innerStyle);
+            });
+            var finalStyle = mergeStyles.apply(void 0, __spreadArray([originalStyle], mergedStyles, false));
+            if (href) {
+                self.linkNodes.push({ type: LinkNodeType.DIV, href: href, id: id });
+            }
+            // 确保link节点在正确的text层级内
+            var $parent = $(this).parent();
+            var isInText = $parent.is("text") || $parent.closest("text").length > 0;
+            if (isInText) {
+                // 如果已经在text内，直接替换为div
+                $(this).replaceWith("<div style=\"".concat(finalStyle, "\" id=\"").concat(id, "\" class=\"PA_RichTextHref_ATag\">").concat(textContent, "</div>"));
+            }
+            else {
+                // 如果不在text内，需要确保在正确的层级
+                $(this).replaceWith("<div style=\"".concat(finalStyle, "\" id=\"").concat(id, "\" class=\"PA_RichTextHref_ATag\">").concat(textContent, "</div>"));
+            }
+        });
+    };
+    /** 用 text 标签包裹纯文本节点 */
+    RichText_Refactor.wrapTextNodes = function ($) {
+        var self = this;
+        $("*").each(function () {
+            var nodeId = $(this).attr("id") || "";
+            if (nodeId.startsWith("PA_RichTextHrefId_"))
+                return;
+            var isListItem = $(this).attr("data-list-item") === "true";
+            if (isListItem)
+                return;
+            $(this)
+                .contents()
+                .each(function () {
+                var linkParent = $(this).closest("[id^='PA_RichTextHrefId_']");
+                if (linkParent.length > 0)
+                    return;
+                var listParent = $(this).closest("[data-list-item='true']");
+                if (listParent.length > 0)
+                    return;
+                if (this.type === "text") {
+                    var text = this.data.trim();
+                    if (text.length > 0) {
+                        $(this).replaceWith("<text style=\"".concat(mergeStyles("word-break: break-word", "flex-shrink: 0", "flex-direction: row"), "\">").concat(text, "</text>"));
+                    }
+                }
+            });
+        });
+    };
+    /** strong / em / u / s / span 等标签替换成 text */
+    RichText_Refactor.replaceStyleTags = function ($) {
+        var tagToStyle = {
+            strong: "font-weight: bold",
+            em: "font-style: italic",
+            u: "text-decoration: underline",
+            s: "text-decoration: line-through",
+        };
+        Object.entries(tagToStyle).forEach(function (_a) {
+            var tag = _a[0], style = _a[1];
+            $(tag).each(function () {
+                var html = $(this).html();
+                var oriStyle = $(this).attr("style") || "";
+                $(this).replaceWith("<text style=\"".concat(mergeStyles(oriStyle, style, "flex-shrink: 0"), "\">").concat(html, "</text>"));
+            });
+        });
+        $("span").each(function () {
+            var html = $(this).html();
+            var oriStyle = $(this).attr("style") || "";
+            $(this).replaceWith("<text style=\"".concat(mergeStyles(oriStyle, "flex-shrink: 0"), "\">").concat(html, "</text>"));
+        });
+    };
+    /** p → div */
+    RichText_Refactor.replacePTag = function ($) {
+        $("p").each(function () {
+            var html = $(this).html();
+            var style = $(this).attr("style") || "";
+            $(this).replaceWith("<div style=\"".concat(mergeStyles(style, "flex-shrink: 0", "width:100%"), "\">").concat(html, "</div>"));
+        });
+    };
+    /** img 的 href 转移处理 & 记录链接 */
+    RichText_Refactor.handleImgHref = function ($) {
+        var self = this;
+        $("img").each(function () {
+            var id = "PA_RichTextHrefId_".concat(self.hrefIdCnt++);
+            $(this).attr("id", id);
+            var href = $(this).attr("href");
+            if (href) {
+                self.linkNodes.push({ type: LinkNodeType.IMG, href: href, id: id });
+            }
+            $(this).attr("href", "");
+            $(this).attr("class", "PA_RichTextHref_ImgTag");
+            $(this).attr("data-href", href);
+        });
+    };
+    /** 给指定标签补 flex-shrink:0 */
+    RichText_Refactor.addFlexShrink = function ($) {
+        ["h1", "h2", "h3", "h4", "h5", "h6", "a", "img", "div"].forEach(function (tag) {
+            $(tag).each(function () {
+                var isListItem = $(this).attr("data-list-item") === "true";
+                var inListItem = $(this).closest("[data-list-item='true']").length > 0;
+                if (!isListItem && !inListItem) {
+                    var style = $(this).attr("style") || "";
+                    $(this).attr("style", mergeStyles(style, "flex-shrink: 0"));
+                }
+            });
+        });
+    };
+    /** 把嵌套的 text 展平 */
+    RichText_Refactor.flattenNestedText = function ($) {
+        while ($("text > text").length > 0) {
+            $("text").each(function () {
+                var $this = $(this);
+                var parentStyle = $this.attr("style") || "";
+                $this.children("text").each(function () {
+                    var $child = $(this);
+                    var childStyle = $child.attr("style") || "";
+                    var mergedStyle = mergeStyles(parentStyle, childStyle);
+                    $child.attr("style", mergedStyle);
+                });
+                if ($this.children("text").length > 0) {
+                    $this.replaceWith($this.html() || "");
+                }
+            });
+        }
+    };
+    /** 将同一行的 text 节点转为 div 并外包一层 text */
+    RichText_Refactor.convertSiblingTextToDiv = function ($) {
+        var nodeArr = [];
+        ["h1", "h2", "h3", "h4", "h5", "h6", "div"].forEach(function (tag) {
+            $(tag).each(function () {
+                var nodeId = $(this).attr("id") || "";
+                var isListItem = $(this).attr("data-list-item") === "true";
+                var inListItem = $(this).closest("[data-list-item='true']").length > 0;
+                if (!nodeId.startsWith("PA_RichTextHrefId_") && !isListItem && !inListItem) {
+                    nodeArr.push(this);
+                }
+            });
+        });
+        nodeArr.forEach(function (node) {
+            var tag = $(node).prop("tagName");
+            var nodeId = $(node).attr("id") || "";
+            // 处理子元素：将text转为div，但保留link节点
+            $(node)
+                .children("text")
+                .each(function () {
+                var inListItem = $(this).closest("[data-list-item='true']").length > 0;
+                if (inListItem)
+                    return;
+                var text = $(this).html();
+                var style = $(this).attr("style") || "";
+                // 检查是否包含link节点
+                var hasLink = $(this).find('[id^="PA_RichTextHrefId_"]').length > 0;
+                if (hasLink) {
+                    // 如果包含link节点，需要特殊处理以保持link在正确位置
+                    var $tempDiv = $("<div style=\"".concat(mergeStyles(style, "word-break: break-word", "flex-shrink: 0", "flex-direction: row"), "\">").concat(text, "</div>"));
+                    $(this).replaceWith($tempDiv);
+                }
+                else {
+                    // 普通text节点直接转换
+                    $(this).replaceWith("<div style=\"".concat(mergeStyles(style, "word-break: break-word", "flex-shrink: 0", "flex-direction: row"), "\">").concat(text, "</div>"));
+                }
+            });
+            var tagHtml = $(node).html() || "";
+            var tagStyle = $(node).attr("style") || "";
+            if (tagHtml.trim()) {
+                var idAttr = nodeId ? " id=\"".concat(nodeId, "\"") : "";
+                var customAttrs = "";
+                var attribs = ($(node).get(0) || {}).attribs || {};
+                for (var _i = 0, _a = Object.entries(attribs); _i < _a.length; _i++) {
+                    var _b = _a[_i], k = _b[0], v = _b[1];
+                    if (k !== "style" && k !== "id") {
+                        customAttrs += " ".concat(k, "=\"").concat(v, "\"");
+                    }
+                }
+                // 保证外层tag的style不合并子div的style
+                $(node).replaceWith("<".concat(tag, " style=\"").concat(mergeStyles(tagStyle, "flex-direction: row"), "\"").concat(idAttr).concat(customAttrs, "><text style=\"").concat(mergeStyles("flex-shrink: 0", "width: 100%", "line-height: 1"), "\">").concat(tagHtml, "</text></").concat(tag, ">"));
+            }
+        });
+    };
+    /** text-indent 首行缩进处理 */
+    RichText_Refactor.handleTextIndent = function ($) {
+        $("*").each(function () {
+            var textIndent = $(this).css("text-indent");
+            if (textIndent) {
+                var repeatCnt = parseInt(textIndent);
+                if (repeatCnt > 0) {
+                    var spacer = "<div style=\"".concat(mergeStyles("color: transparent", "flex-shrink: 0", "font-size: 16px"), "\">").concat("一".repeat(repeatCnt), "</div>");
+                    var textChild = $(this).children("text").first();
+                    if (textChild.length > 0) {
+                        var first = textChild.children().first();
+                        if (first.length > 0)
+                            first.before(spacer);
+                        else
+                            textChild.append(spacer);
+                    }
+                }
+            }
+        });
+    };
+    /** line-height / letter-spacing 调整 */
+    RichText_Refactor.adjustLineHeightAndLetterSpacing = function ($, config) {
+        $("text").each(function () {
+            var $text = $(this);
+            var maxLineHeight = 0;
+            $text.children("div").each(function () {
+                var lh = parseInt($(this).css("line-height") || "1");
+                maxLineHeight = Math.max(maxLineHeight, lh);
+            });
+            var scale = (config === null || config === void 0 ? void 0 : config.lineHeightScale) || 1;
+            if (maxLineHeight > 0) {
+                var currentStyle = $text.attr("style") || "";
+                $text.attr("style", mergeStyles(currentStyle, "line-height: ".concat(maxLineHeight * scale)));
+            }
+        });
+        $("text").each(function () {
+            var $text = $(this);
+            var maxLS = 0;
+            $text.children("div").each(function () {
+                var ls = $(this).css("letter-spacing") || "0";
+                var lsNum = parseInt(ls);
+                maxLS = Math.max(maxLS, lsNum);
+            });
+            if (maxLS > 0) {
+                var currentStyle = $text.attr("style") || "";
+                $text.attr("style", mergeStyles(currentStyle, "letter-spacing: ".concat(maxLS, "rem")));
+            }
+        });
+    };
+    /** 把 div 的 text-align 转移到子 text 上 */
+    RichText_Refactor.transferTextAlign = function ($) {
+        $("div").each(function () {
+            var ta = $(this).css("text-align") || "";
+            if (ta) {
+                $(this)
+                    .children("text")
+                    .each(function () {
+                    var currentStyle = $(this).attr("style") || "";
+                    $(this).attr("style", mergeStyles(currentStyle, "text-align: ".concat(ta)));
+                });
+                // 清除div的text-align
+                var currentStyle = $(this).attr("style") || "";
+                var styleObj = parseStyleString(currentStyle);
+                delete styleObj["text-align"];
+                $(this).attr("style", serializeStyleObject(styleObj));
+            }
+        });
+    };
+    /** 删除空 text 节点 */
+    RichText_Refactor.removeEmptyText = function ($) {
+        $("text").each(function () {
+            var t = $(this).html() || "";
+            if (t.trim() === "")
+                $(this).remove();
+        });
+    };
+    /** 补默认 heading 字体大小 */
+    RichText_Refactor.fixHeadingFontSize = function ($) {
+        var hRem = ["2rem", "1.5rem", "1.17rem", "1rem", "0.83rem", "0.67rem"];
+        ["h1", "h2", "h3", "h4", "h5", "h6"].forEach(function (tag) {
+            $(tag).each(function () {
+                var idx = parseInt(tag.replace("h", "")) - 1;
+                var style = $(this).attr("style") || "";
+                if (!style.includes("font-size")) {
+                    $(this).attr("style", mergeStyles(style, "font-size:".concat(hRem[idx])));
+                }
+            });
+        });
+    };
+    // 存储需要绑定点击事件的节点
+    RichText_Refactor.linkNodes = [];
+    RichText_Refactor.hrefIdCnt = 0;
+    return RichText_Refactor;
+}());
+exports.RichText_Refactor = RichText_Refactor;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@pixui-dev/pixui-richtext-helper",
-    "version": "0.1.1-beta.2",
+    "version": "0.1.1-beta.3",
     "description": "pixui richtext helper",
     "main": "dist/index.js",
     "types": "dist/index.d.ts",
@@ -19,8 +19,9 @@
     "author": "jnjnjnzhang",
     "license": "ISC",
     "devDependencies": {
-        "@types/node": "^22.5.4",
-        "typescript": "^5.0.0"
+        "@types/node": "^22.15.33",
+        "ts-node": "^10.9.2",
+        "typescript": "^5.8.3"
     },
     "dependencies": {
         "cheerio": "1.0.0-rc.10"