@eva/plugin-renderer-text 2.0.1-beta.26 → 2.0.1-beta.28

package/dist/EVA.plugin.renderer.text.js

@@ -60,6 +60,7 @@ var _EVA_IIFE_text = function (exports, pixi_js, eva_js, pluginRenderer, rendere
       super(...arguments);
       this.text = '';
       this.style = {};
+      this.resolution = 1;
     }
     init(obj) {
       const style = new pixi_js.TextStyle({
@@ -76,11 +77,15 @@ var _EVA_IIFE_text = function (exports, pixi_js, eva_js, pluginRenderer, rendere
       if (obj) {
         this.text = obj.text;
         _extends(this.style, obj.style);
+        if (obj.resolution !== undefined) {
+          this.resolution = obj.resolution;
+        }
       }
     }
   }
   Text$2.componentName = 'Text';
   __decorate([type('string')], Text$2.prototype, "text", void 0);
+  __decorate([type('number')], Text$2.prototype, "resolution", void 0);
   class HTMLText extends eva_js.Component {
     constructor() {
       super(...arguments);
@@ -154,6 +159,9 @@ var _EVA_IIFE_text = function (exports, pixi_js, eva_js, pluginRenderer, rendere
         delete styleWithoutFont.fontFamily;
         const initialText = fontFamily ? '' : component.text;
         const text = new rendererAdapter.Text(initialText, styleWithoutFont);
+        if (component.resolution !== undefined && component.resolution > 0) {
+          text.resolution = component.resolution;
+        }
         this.containerManager.getContainer(changed.gameObject.id).addChildAt(text, 0);
         this.texts[changed.gameObject.id] = {
           text,
@@ -215,6 +223,11 @@ var _EVA_IIFE_text = function (exports, pixi_js, eva_js, pluginRenderer, rendere
         text.text = component.text;
       } else if (changed.prop.prop[0] === 'style') {
         _extends(text.style, component.style);
+      } else if (changed.prop.prop[0] === 'resolution' && !isHTMLText) {
+        const textComponent = component;
+        if (textComponent.resolution !== undefined && textComponent.resolution > 0) {
+          text.resolution = textComponent.resolution;
+        }
       } else if (changed.prop.prop[0] === 'textureStyle' && isHTMLText) {
         const htmlComponent = component;
         const container = this.containerManager.getContainer(changed.gameObject.id);
@@ -250,7 +263,7 @@ var _EVA_IIFE_text = function (exports, pixi_js, eva_js, pluginRenderer, rendere
     Text: ['text', {
       prop: ['style'],
       deep: true
-    }],
+    }, 'resolution'],
     HTMLText: ['text', {
       prop: ['style'],
       deep: true

package/dist/EVA.plugin.renderer.text.min.js

@@ -1 +1 @@
-function _extends(){return _extends=Object.assign?Object.assign.bind():function(t){for(var e=1;e<arguments.length;e++){var n=arguments[e];for(var i in n)({}).hasOwnProperty.call(n,i)&&(t[i]=n[i])}return t},_extends.apply(null,arguments)}globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_text=function(t,e,n,i,o){"use strict";function s(t,e,n,i){var o,s=arguments.length,r=s<3?e:null===i?i=Object.getOwnPropertyDescriptor(e,n):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(t,e,n,i);else for(var c=t.length-1;c>=0;c--)(o=t[c])&&(r=(s<3?o(r):s>3?o(e,n,r):o(e,n))||r);return s>3&&r&&Object.defineProperty(e,n,r),r}function r(t,e,n,i){return new(n||(n=Promise))((function(o,s){function r(t){try{l(i.next(t))}catch(t){s(t)}}function c(t){try{l(i.throw(t))}catch(t){s(t)}}function l(t){var e;t.done?o(t.value):(e=t.value,e instanceof n?e:new n((function(t){t(e)}))).then(r,c)}l((i=i.apply(t,e||[])).next())}))}function c(t){return function(e,n){var i=function(t,e){return t.constructor.IDEProps||(t.constructor.IDEProps={}),t.constructor.IDEProps[e]||(t.constructor.IDEProps[e]={}),t.constructor.IDEProps[e]}(e,n);i.key=n,i.type=t}}class l extends n.Component{constructor(){super(...arguments),this.text="",this.style={}}init(t){const n=new e.TextStyle({fontSize:20}),i={};for(const t in n)0===t.indexOf("_")&&(i[t.substring(1)]=n[t]);delete i.styleKey,this.style=i,t&&(this.text=t.text,_extends(this.style,t.style))}}l.componentName="Text",s([c("string")],l.prototype,"text",void 0);class a extends n.Component{constructor(){super(...arguments),this.text="",this.style={},this.textureStyle={}}init(t){this.style=_extends({fontSize:24,fill:"#000000",fontFamily:"Arial"},null==t?void 0:t.style),this.textureStyle=_extends({scaleMode:"linear",resolution:window.devicePixelRatio||1},null==t?void 0:t.textureStyle),t&&(this.text=t.text)}}a.componentName="HTMLText",s([c("string")],a.prototype,"text",void 0);let d=class extends i.Renderer{constructor(){super(...arguments),this.name="Text",this.texts={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(t){return r(this,void 0,void 0,(function*(){const e="Text"===t.componentName,i="HTMLText"===t.componentName;if(e||i)if(t.type===n.OBSERVER_TYPE.ADD)e?yield this.addTextComponent(t):yield this.addHTMLTextComponent(t),this.setSize(t);else if(t.type===n.OBSERVER_TYPE.REMOVE)this.containerManager.getContainer(t.gameObject.id).removeChild(this.texts[t.gameObject.id].text),this.texts[t.gameObject.id].text.destroy({children:!0}),delete this.texts[t.gameObject.id];else{this.change(t);const e=t.component;if("style"===t.prop.prop[0]&&e.style&&e.style.fontFamily){const{text:n}=this.texts[t.gameObject.id];yield this.waitForFontResource(n,t,e.style.fontFamily)}this.setSize(t)}}))}addTextComponent(t){return r(this,void 0,void 0,(function*(){const e=t.component,n=_extends({},e.style),i=n.fontFamily;delete n.fontFamily;const s=i?"":e.text,r=new o.Text(s,n);this.containerManager.getContainer(t.gameObject.id).addChildAt(r,0),this.texts[t.gameObject.id]={text:r,component:e},i&&(yield this.waitForFontResource(r,t,i))}))}addHTMLTextComponent(t){return r(this,void 0,void 0,(function*(){const e=t.component,n=_extends({},e.style),i=n.fontFamily;delete n.fontFamily;const s=i?"":e.text,r=new o.HTMLText(_extends({text:s,style:n},e.textureStyle&&{textureStyle:e.textureStyle}));this.containerManager.getContainer(t.gameObject.id).addChildAt(r,0),this.texts[t.gameObject.id]={text:r,component:e},i&&(yield this.waitForFontResource(r,t,i))}))}waitForFontResource(t,e,i){return r(this,void 0,void 0,(function*(){if(i)try{const o=Array.isArray(i)?i[0]:i,s=this.increaseAsyncId(e.gameObject.id);if(yield n.resource.getResource(o),!this.validateAsyncId(e.gameObject.id,s))return;const r=this.texts[e.gameObject.id].component;t.style.fontFamily=i,t.text=r.text}catch(t){console.warn(`字体资源 ${i} 加载失败:`,t)}}))}change(t){const{text:e,component:n}=this.texts[t.gameObject.id],i="HTMLText"===t.componentName;if("text"===t.prop.prop[0])e.text=n.text;else if("style"===t.prop.prop[0])_extends(e.style,n.style);else if("textureStyle"===t.prop.prop[0]&&i){const i=n,s=this.containerManager.getContainer(t.gameObject.id),r=s.getChildIndex(e);s.removeChild(e),e.destroy({children:!0});const c=new o.HTMLText({text:i.text,style:i.style,textureStyle:i.textureStyle});s.addChildAt(c,r),this.texts[t.gameObject.id].text=c}}setSize(t){const{transform:e}=t.gameObject;if(!e)return;const{text:n}=this.texts[t.gameObject.id],i=n.getSize();e.size.width=i.width,e.size.height=i.height}};d.systemName="Text",d=s([n.decorators.componentObserver({Text:["text",{prop:["style"],deep:!0}],HTMLText:["text",{prop:["style"],deep:!0},{prop:["textureStyle"],deep:!0}]})],d);var x=d;return t.HTMLText=a,t.Text=l,t.TextSystem=x,Object.defineProperty(t,"__esModule",{value:!0}),t}({},PIXI,EVA,EVA.plugin.renderer,EVA.rendererAdapter);globalThis.EVA.plugin.renderer.text=globalThis.EVA.plugin.renderer.text||_EVA_IIFE_text;
+function _extends(){return _extends=Object.assign?Object.assign.bind():function(t){for(var e=1;e<arguments.length;e++){var n=arguments[e];for(var o in n)({}).hasOwnProperty.call(n,o)&&(t[o]=n[o])}return t},_extends.apply(null,arguments)}globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_text=function(t,e,n,o,i){"use strict";function s(t,e,n,o){var i,s=arguments.length,r=s<3?e:null===o?o=Object.getOwnPropertyDescriptor(e,n):o;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(t,e,n,o);else for(var l=t.length-1;l>=0;l--)(i=t[l])&&(r=(s<3?i(r):s>3?i(e,n,r):i(e,n))||r);return s>3&&r&&Object.defineProperty(e,n,r),r}function r(t,e,n,o){return new(n||(n=Promise))((function(i,s){function r(t){try{c(o.next(t))}catch(t){s(t)}}function l(t){try{c(o.throw(t))}catch(t){s(t)}}function c(t){var e;t.done?i(t.value):(e=t.value,e instanceof n?e:new n((function(t){t(e)}))).then(r,l)}c((o=o.apply(t,e||[])).next())}))}function l(t){return function(e,n){var o=function(t,e){return t.constructor.IDEProps||(t.constructor.IDEProps={}),t.constructor.IDEProps[e]||(t.constructor.IDEProps[e]={}),t.constructor.IDEProps[e]}(e,n);o.key=n,o.type=t}}class c extends n.Component{constructor(){super(...arguments),this.text="",this.style={},this.resolution=1}init(t){const n=new e.TextStyle({fontSize:20}),o={};for(const t in n)0===t.indexOf("_")&&(o[t.substring(1)]=n[t]);delete o.styleKey,this.style=o,t&&(this.text=t.text,_extends(this.style,t.style),void 0!==t.resolution&&(this.resolution=t.resolution))}}c.componentName="Text",s([l("string")],c.prototype,"text",void 0),s([l("number")],c.prototype,"resolution",void 0);class a extends n.Component{constructor(){super(...arguments),this.text="",this.style={},this.textureStyle={}}init(t){this.style=_extends({fontSize:24,fill:"#000000",fontFamily:"Arial"},null==t?void 0:t.style),this.textureStyle=_extends({scaleMode:"linear",resolution:window.devicePixelRatio||1},null==t?void 0:t.textureStyle),t&&(this.text=t.text)}}a.componentName="HTMLText",s([l("string")],a.prototype,"text",void 0);let d=class extends o.Renderer{constructor(){super(...arguments),this.name="Text",this.texts={}}init(){this.renderSystem=this.game.getSystem(o.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(t){return r(this,void 0,void 0,(function*(){const e="Text"===t.componentName,o="HTMLText"===t.componentName;if(e||o)if(t.type===n.OBSERVER_TYPE.ADD)e?yield this.addTextComponent(t):yield this.addHTMLTextComponent(t),this.setSize(t);else if(t.type===n.OBSERVER_TYPE.REMOVE)this.containerManager.getContainer(t.gameObject.id).removeChild(this.texts[t.gameObject.id].text),this.texts[t.gameObject.id].text.destroy({children:!0}),delete this.texts[t.gameObject.id];else{this.change(t);const e=t.component;if("style"===t.prop.prop[0]&&e.style&&e.style.fontFamily){const{text:n}=this.texts[t.gameObject.id];yield this.waitForFontResource(n,t,e.style.fontFamily)}this.setSize(t)}}))}addTextComponent(t){return r(this,void 0,void 0,(function*(){const e=t.component,n=_extends({},e.style),o=n.fontFamily;delete n.fontFamily;const s=o?"":e.text,r=new i.Text(s,n);void 0!==e.resolution&&e.resolution>0&&(r.resolution=e.resolution),this.containerManager.getContainer(t.gameObject.id).addChildAt(r,0),this.texts[t.gameObject.id]={text:r,component:e},o&&(yield this.waitForFontResource(r,t,o))}))}addHTMLTextComponent(t){return r(this,void 0,void 0,(function*(){const e=t.component,n=_extends({},e.style),o=n.fontFamily;delete n.fontFamily;const s=o?"":e.text,r=new i.HTMLText(_extends({text:s,style:n},e.textureStyle&&{textureStyle:e.textureStyle}));this.containerManager.getContainer(t.gameObject.id).addChildAt(r,0),this.texts[t.gameObject.id]={text:r,component:e},o&&(yield this.waitForFontResource(r,t,o))}))}waitForFontResource(t,e,o){return r(this,void 0,void 0,(function*(){if(o)try{const i=Array.isArray(o)?o[0]:o,s=this.increaseAsyncId(e.gameObject.id);if(yield n.resource.getResource(i),!this.validateAsyncId(e.gameObject.id,s))return;const r=this.texts[e.gameObject.id].component;t.style.fontFamily=o,t.text=r.text}catch(t){console.warn(`字体资源 ${o} 加载失败:`,t)}}))}change(t){const{text:e,component:n}=this.texts[t.gameObject.id],o="HTMLText"===t.componentName;if("text"===t.prop.prop[0])e.text=n.text;else if("style"===t.prop.prop[0])_extends(e.style,n.style);else if("resolution"!==t.prop.prop[0]||o){if("textureStyle"===t.prop.prop[0]&&o){const o=n,s=this.containerManager.getContainer(t.gameObject.id),r=s.getChildIndex(e);s.removeChild(e),e.destroy({children:!0});const l=new i.HTMLText({text:o.text,style:o.style,textureStyle:o.textureStyle});s.addChildAt(l,r),this.texts[t.gameObject.id].text=l}}else{const t=n;void 0!==t.resolution&&t.resolution>0&&(e.resolution=t.resolution)}}setSize(t){const{transform:e}=t.gameObject;if(!e)return;const{text:n}=this.texts[t.gameObject.id],o=n.getSize();e.size.width=o.width,e.size.height=o.height}};d.systemName="Text",d=s([n.decorators.componentObserver({Text:["text",{prop:["style"],deep:!0},"resolution"],HTMLText:["text",{prop:["style"],deep:!0},{prop:["textureStyle"],deep:!0}]})],d);var u=d;return t.HTMLText=a,t.Text=c,t.TextSystem=u,Object.defineProperty(t,"__esModule",{value:!0}),t}({},PIXI,EVA,EVA.plugin.renderer,EVA.rendererAdapter);globalThis.EVA.plugin.renderer.text=globalThis.EVA.plugin.renderer.text||_EVA_IIFE_text;

package/dist/plugin-renderer-text.cjs.js

@@ -39,12 +39,66 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
+/**
+ * 文本组件（基于 PixiJS Text）
+ *
+ * Text 组件用于渲染文本内容，支持丰富的文本样式配置。
+ * 它基于 PixiJS 的 Text 实现，支持字体、颜色、描边、阴影、对齐等多种样式。
+ *
+ * 主要特性：
+ * - 支持多种字体和字号
+ * - 支持文本颜色、渐变填充
+ * - 支持描边和投影效果
+ * - 支持文本对齐和换行
+ * - 可配置渲染分辨率
+ *
+ * @example
+ * ```typescript
+ * // 基础文本
+ * const label = new GameObject('label');
+ * label.addComponent(new Text({
+ *   text: 'Hello EVA!',
+ *   style: {
+ *     fontSize: 32,
+ *     fill: 0xffffff
+ *   }
+ * }));
+ *
+ * // 带样式的文本
+ * label.addComponent(new Text({
+ *   text: '得分: 9999',
+ *   style: {
+ *     fontFamily: 'Arial',
+ *     fontSize: 48,
+ *     fontWeight: 'bold',
+ *     fill: ['#ff0000', '#ffff00'], // 渐变色
+ *     stroke: '#000000',
+ *     strokeThickness: 4,
+ *     dropShadow: true,
+ *     dropShadowDistance: 3
+ *   },
+ *   resolution: 2 // 高清渲染
+ * }));
+ * ```
+ */
 class Text$2 extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** 文本内容 */
         this.text = '';
+        /** 文本样式配置 */
+        // @decorators.IDEProp 复杂编辑后续添加
         this.style = {};
+        /** 渲染分辨率，值越大文本越清晰但性能消耗越大 */
+        this.resolution = 1;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.text - 文本内容
+     * @param obj.style - 文本样式
+     * @param obj.resolution - 渲染分辨率
+     */
     init(obj) {
         const style = new pixi_js.TextStyle({
             fontSize: 20,
@@ -60,21 +114,99 @@ class Text$2 extends eva_js.Component {
         if (obj) {
             this.text = obj.text;
             Object.assign(this.style, obj.style);
+            if (obj.resolution !== undefined) {
+                this.resolution = obj.resolution;
+            }
         }
     }
 }
+/** 组件名称 */
 Text$2.componentName = 'Text';
 __decorate([
     inspectorDecorator.type('string')
-], Text$2.prototype, "text", void 0);
+], Text$2.prototype, "text", void 0);
+__decorate([
+    inspectorDecorator.type('number')
+], Text$2.prototype, "resolution", void 0);
 
+/**
+ * HTML 富文本组件
+ *
+ * HTMLText 组件支持渲染带有 HTML 标签的富文本内容。
+ * 可以在文本中使用 HTML 标签（如 `<b>`, `<i>`, `<span>` 等）来实现丰富的文本样式，
+ * 适用于聊天对话、新闻内容、富文本显示等需要多样式文本的场景。
+ *
+ * 支持的 HTML 标签：
+ * - `<b>` - 粗体
+ * - `<i>` - 斜体
+ * - `<span style="color:#ff0000">` - 自定义样式
+ * - `<br>` - 换行
+ * 以及更多标准 HTML 文本标签
+ *
+ * @example
+ * ```typescript
+ * // 基础富文本
+ * const label = new GameObject('label');
+ * label.addComponent(new HTMLText({
+ *   text: '这是<b>粗体</b>和<i>斜体</i>文本',
+ *   style: {
+ *     fontSize: 24,
+ *     fill: '#000000',
+ *     fontFamily: 'Arial'
+ *   }
+ * }));
+ *
+ * // 带颜色的富文本
+ * label.addComponent(new HTMLText({
+ *   text: '欢迎 <span style="color:#ff0000">玩家123</span> 加入游戏！',
+ *   style: {
+ *     fontSize: 20,
+ *     wordWrap: true,
+ *     wordWrapWidth: 300
+ *   }
+ * }));
+ *
+ * // 自定义标签样式
+ * label.addComponent(new HTMLText({
+ *   text: '获得 <gold>100</gold> 金币',
+ *   style: {
+ *     fontSize: 18,
+ *     tagStyles: {
+ *       gold: {
+ *         fill: '#ffd700',
+ *         fontWeight: 'bold'
+ *       }
+ *     }
+ *   }
+ * }));
+ *
+ * // 高分辨率渲染
+ * label.addComponent(new HTMLText({
+ *   text: '高清文本',
+ *   textureStyle: {
+ *     resolution: 2,
+ *     scaleMode: 'linear'
+ *   }
+ * }));
+ * ```
+ */
 class HTMLText extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** 富文本内容（支持 HTML 标签） */
         this.text = '';
+        /** 文本样式配置 */
         this.style = {};
+        /** 纹理渲染配置 */
         this.textureStyle = {};
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.text - 富文本内容
+     * @param obj.style - 文本样式
+     * @param obj.textureStyle - 纹理配置
+     */
     init(obj) {
         this.style = Object.assign({ fontSize: 24, fill: '#000000', fontFamily: 'Arial' }, obj === null || obj === void 0 ? void 0 : obj.style);
         this.textureStyle = Object.assign({ scaleMode: 'linear', resolution: window.devicePixelRatio || 1 }, obj === null || obj === void 0 ? void 0 : obj.textureStyle);
@@ -83,6 +215,7 @@ class HTMLText extends eva_js.Component {
         }
     }
 }
+/** 组件名称 */
 HTMLText.componentName = 'HTMLText';
 __decorate([
     inspectorDecorator.type('string')
@@ -120,6 +253,7 @@ let Text = class Text extends pluginRenderer.Renderer {
             }
             else {
                 this.change(changed);
+                // 如果样式改变且涉及字体，也需要等待字体资源加载
                 const component = changed.component;
                 if (changed.prop.prop[0] === 'style' && component.style && component.style.fontFamily) {
                     const { text } = this.texts[changed.gameObject.id];
@@ -132,16 +266,22 @@ let Text = class Text extends pluginRenderer.Renderer {
     addTextComponent(changed) {
         return __awaiter(this, void 0, void 0, function* () {
             const component = changed.component;
+            // 创建文本样式副本，先不设置 fontFamily
             const styleWithoutFont = Object.assign({}, component.style);
             const fontFamily = styleWithoutFont.fontFamily;
             delete styleWithoutFont.fontFamily;
             const initialText = fontFamily ? '' : component.text;
             const text = new rendererAdapter.Text(initialText, styleWithoutFont);
+            // 设置 resolution 以提升清晰度
+            if (component.resolution !== undefined && component.resolution > 0) {
+                text.resolution = component.resolution;
+            }
             this.containerManager.getContainer(changed.gameObject.id).addChildAt(text, 0);
             this.texts[changed.gameObject.id] = {
                 text,
                 component,
             };
+            // 如果指定了字体资源，等待资源加载完成后设置 fontFamily
             if (fontFamily) {
                 yield this.waitForFontResource(text, changed, fontFamily);
             }
@@ -150,6 +290,7 @@ let Text = class Text extends pluginRenderer.Renderer {
     addHTMLTextComponent(changed) {
         return __awaiter(this, void 0, void 0, function* () {
             const component = changed.component;
+            // 创建样式副本，先不设置 fontFamily
             const styleWithoutFont = Object.assign({}, component.style);
             const fontFamily = styleWithoutFont.fontFamily;
             delete styleWithoutFont.fontFamily;
@@ -160,11 +301,15 @@ let Text = class Text extends pluginRenderer.Renderer {
                 text: htmlText,
                 component,
             };
+            // 如果指定了字体资源，等待资源加载完成后设置 fontFamily
             if (fontFamily) {
                 yield this.waitForFontResource(htmlText, changed, fontFamily);
             }
         });
     }
+    /**
+     * 等待字体资源加载完成并更新文本
+     */
     waitForFontResource(text, changed, fontFamily) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!fontFamily) {
@@ -172,13 +317,17 @@ let Text = class Text extends pluginRenderer.Renderer {
             }
             try {
                 const fontName = Array.isArray(fontFamily) ? fontFamily[0] : fontFamily;
+                // 通过 resource 系统获取字体资源
                 const asyncId = this.increaseAsyncId(changed.gameObject.id);
                 yield eva_js.resource.getResource(fontName);
+                // 验证异步操作是否仍然有效（防止组件已被移除）
                 if (!this.validateAsyncId(changed.gameObject.id, asyncId))
                     return;
+                // 字体资源加载成功后，设置 fontFamily 并重新设置文本内容以触发重新渲染
                 const component = this.texts[changed.gameObject.id].component;
                 text.style.fontFamily = fontFamily;
                 text.text = component.text;
+                // 更新尺寸
             }
             catch (error) {
                 console.warn(`字体资源 ${fontFamily} 加载失败:`, error);
@@ -194,7 +343,15 @@ let Text = class Text extends pluginRenderer.Renderer {
         else if (changed.prop.prop[0] === 'style') {
             Object.assign(text.style, component.style);
         }
+        else if (changed.prop.prop[0] === 'resolution' && !isHTMLText) {
+            // 更新 resolution
+            const textComponent = component;
+            if (textComponent.resolution !== undefined && textComponent.resolution > 0) {
+                text.resolution = textComponent.resolution;
+            }
+        }
         else if (changed.prop.prop[0] === 'textureStyle' && isHTMLText) {
+            // HTMLText 纹理样式变化需要重新创建
             const htmlComponent = component;
             const container = this.containerManager.getContainer(changed.gameObject.id);
             const index = container.getChildIndex(text);
@@ -222,7 +379,7 @@ let Text = class Text extends pluginRenderer.Renderer {
 Text.systemName = 'Text';
 Text = __decorate([
     eva_js.decorators.componentObserver({
-        Text: ['text', { prop: ['style'], deep: true }],
+        Text: ['text', { prop: ['style'], deep: true }, 'resolution'],
         HTMLText: ['text', { prop: ['style'], deep: true }, { prop: ['textureStyle'], deep: true }],
     })
 ], Text);

package/dist/plugin-renderer-text.cjs.prod.js

@@ -1,4 +1,4 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("pixi.js"),t=require("@eva/eva.js"),n=require("@eva/inspector-decorator"),i=require("@eva/plugin-renderer"),s=require("@eva/renderer-adapter");
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("pixi.js"),t=require("@eva/eva.js"),i=require("@eva/inspector-decorator"),o=require("@eva/plugin-renderer"),n=require("@eva/renderer-adapter");
 /*! *****************************************************************************
 Copyright (c) Microsoft Corporation. All rights reserved.
 Licensed under the Apache License, Version 2.0 (the "License"); you may not use
@@ -13,4 +13,4 @@ MERCHANTABLITY OR NON-INFRINGEMENT.
 See the Apache Version 2.0 License for specific language governing permissions
 and limitations under the License.
 ***************************************************************************** */
-function o(e,t,n,i){var s,o=arguments.length,r=o<3?t:null===i?i=Object.getOwnPropertyDescriptor(t,n):i;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(e,t,n,i);else for(var c=e.length-1;c>=0;c--)(s=e[c])&&(r=(o<3?s(r):o>3?s(t,n,r):s(t,n))||r);return o>3&&r&&Object.defineProperty(t,n,r),r}function r(e,t,n,i){return new(n||(n=Promise))((function(s,o){function r(e){try{a(i.next(e))}catch(e){o(e)}}function c(e){try{a(i.throw(e))}catch(e){o(e)}}function a(e){e.done?s(e.value):new n((function(t){t(e.value)})).then(r,c)}a((i=i.apply(e,t||[])).next())}))}class c extends t.Component{constructor(){super(...arguments),this.text="",this.style={}}init(t){const n=new e.TextStyle({fontSize:20}),i={};for(const e in n)0===e.indexOf("_")&&(i[e.substring(1)]=n[e]);delete i.styleKey,this.style=i,t&&(this.text=t.text,Object.assign(this.style,t.style))}}c.componentName="Text",o([n.type("string")],c.prototype,"text",void 0);class a extends t.Component{constructor(){super(...arguments),this.text="",this.style={},this.textureStyle={}}init(e){this.style=Object.assign({fontSize:24,fill:"#000000",fontFamily:"Arial"},null==e?void 0:e.style),this.textureStyle=Object.assign({scaleMode:"linear",resolution:window.devicePixelRatio||1},null==e?void 0:e.textureStyle),e&&(this.text=e.text)}}a.componentName="HTMLText",o([n.type("string")],a.prototype,"text",void 0);let d=class extends i.Renderer{constructor(){super(...arguments),this.name="Text",this.texts={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(e){return r(this,void 0,void 0,(function*(){const n="Text"===e.componentName,i="HTMLText"===e.componentName;if(n||i)if(e.type===t.OBSERVER_TYPE.ADD)n?yield this.addTextComponent(e):yield this.addHTMLTextComponent(e),this.setSize(e);else if(e.type===t.OBSERVER_TYPE.REMOVE)this.containerManager.getContainer(e.gameObject.id).removeChild(this.texts[e.gameObject.id].text),this.texts[e.gameObject.id].text.destroy({children:!0}),delete this.texts[e.gameObject.id];else{this.change(e);const t=e.component;if("style"===e.prop.prop[0]&&t.style&&t.style.fontFamily){const{text:n}=this.texts[e.gameObject.id];yield this.waitForFontResource(n,e,t.style.fontFamily)}this.setSize(e)}}))}addTextComponent(e){return r(this,void 0,void 0,(function*(){const t=e.component,n=Object.assign({},t.style),i=n.fontFamily;delete n.fontFamily;const o=i?"":t.text,r=new s.Text(o,n);this.containerManager.getContainer(e.gameObject.id).addChildAt(r,0),this.texts[e.gameObject.id]={text:r,component:t},i&&(yield this.waitForFontResource(r,e,i))}))}addHTMLTextComponent(e){return r(this,void 0,void 0,(function*(){const t=e.component,n=Object.assign({},t.style),i=n.fontFamily;delete n.fontFamily;const o=i?"":t.text,r=new s.HTMLText(Object.assign({text:o,style:n},t.textureStyle&&{textureStyle:t.textureStyle}));this.containerManager.getContainer(e.gameObject.id).addChildAt(r,0),this.texts[e.gameObject.id]={text:r,component:t},i&&(yield this.waitForFontResource(r,e,i))}))}waitForFontResource(e,n,i){return r(this,void 0,void 0,(function*(){if(i)try{const s=Array.isArray(i)?i[0]:i,o=this.increaseAsyncId(n.gameObject.id);if(yield t.resource.getResource(s),!this.validateAsyncId(n.gameObject.id,o))return;const r=this.texts[n.gameObject.id].component;e.style.fontFamily=i,e.text=r.text}catch(e){console.warn(`字体资源 ${i} 加载失败:`,e)}}))}change(e){const{text:t,component:n}=this.texts[e.gameObject.id],i="HTMLText"===e.componentName;if("text"===e.prop.prop[0])t.text=n.text;else if("style"===e.prop.prop[0])Object.assign(t.style,n.style);else if("textureStyle"===e.prop.prop[0]&&i){const i=n,o=this.containerManager.getContainer(e.gameObject.id),r=o.getChildIndex(t);o.removeChild(t),t.destroy({children:!0});const c=new s.HTMLText({text:i.text,style:i.style,textureStyle:i.textureStyle});o.addChildAt(c,r),this.texts[e.gameObject.id].text=c}}setSize(e){const{transform:t}=e.gameObject;if(!t)return;const{text:n}=this.texts[e.gameObject.id],i=n.getSize();t.size.width=i.width,t.size.height=i.height}};d.systemName="Text",d=o([t.decorators.componentObserver({Text:["text",{prop:["style"],deep:!0}],HTMLText:["text",{prop:["style"],deep:!0},{prop:["textureStyle"],deep:!0}]})],d);var l=d;exports.HTMLText=a,exports.Text=c,exports.TextSystem=l;
+function s(e,t,i,o){var n,s=arguments.length,r=s<3?t:null===o?o=Object.getOwnPropertyDescriptor(t,i):o;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)r=Reflect.decorate(e,t,i,o);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(r=(s<3?n(r):s>3?n(t,i,r):n(t,i))||r);return s>3&&r&&Object.defineProperty(t,i,r),r}function r(e,t,i,o){return new(i||(i=Promise))((function(n,s){function r(e){try{l(o.next(e))}catch(e){s(e)}}function c(e){try{l(o.throw(e))}catch(e){s(e)}}function l(e){e.done?n(e.value):new i((function(t){t(e.value)})).then(r,c)}l((o=o.apply(e,t||[])).next())}))}class c extends t.Component{constructor(){super(...arguments),this.text="",this.style={},this.resolution=1}init(t){const i=new e.TextStyle({fontSize:20}),o={};for(const e in i)0===e.indexOf("_")&&(o[e.substring(1)]=i[e]);delete o.styleKey,this.style=o,t&&(this.text=t.text,Object.assign(this.style,t.style),void 0!==t.resolution&&(this.resolution=t.resolution))}}c.componentName="Text",s([i.type("string")],c.prototype,"text",void 0),s([i.type("number")],c.prototype,"resolution",void 0);class l extends t.Component{constructor(){super(...arguments),this.text="",this.style={},this.textureStyle={}}init(e){this.style=Object.assign({fontSize:24,fill:"#000000",fontFamily:"Arial"},null==e?void 0:e.style),this.textureStyle=Object.assign({scaleMode:"linear",resolution:window.devicePixelRatio||1},null==e?void 0:e.textureStyle),e&&(this.text=e.text)}}l.componentName="HTMLText",s([i.type("string")],l.prototype,"text",void 0);let a=class extends o.Renderer{constructor(){super(...arguments),this.name="Text",this.texts={}}init(){this.renderSystem=this.game.getSystem(o.RendererSystem),this.renderSystem.rendererManager.register(this)}componentChanged(e){return r(this,void 0,void 0,(function*(){const i="Text"===e.componentName,o="HTMLText"===e.componentName;if(i||o)if(e.type===t.OBSERVER_TYPE.ADD)i?yield this.addTextComponent(e):yield this.addHTMLTextComponent(e),this.setSize(e);else if(e.type===t.OBSERVER_TYPE.REMOVE)this.containerManager.getContainer(e.gameObject.id).removeChild(this.texts[e.gameObject.id].text),this.texts[e.gameObject.id].text.destroy({children:!0}),delete this.texts[e.gameObject.id];else{this.change(e);const t=e.component;if("style"===e.prop.prop[0]&&t.style&&t.style.fontFamily){const{text:i}=this.texts[e.gameObject.id];yield this.waitForFontResource(i,e,t.style.fontFamily)}this.setSize(e)}}))}addTextComponent(e){return r(this,void 0,void 0,(function*(){const t=e.component,i=Object.assign({},t.style),o=i.fontFamily;delete i.fontFamily;const s=o?"":t.text,r=new n.Text(s,i);void 0!==t.resolution&&t.resolution>0&&(r.resolution=t.resolution),this.containerManager.getContainer(e.gameObject.id).addChildAt(r,0),this.texts[e.gameObject.id]={text:r,component:t},o&&(yield this.waitForFontResource(r,e,o))}))}addHTMLTextComponent(e){return r(this,void 0,void 0,(function*(){const t=e.component,i=Object.assign({},t.style),o=i.fontFamily;delete i.fontFamily;const s=o?"":t.text,r=new n.HTMLText(Object.assign({text:s,style:i},t.textureStyle&&{textureStyle:t.textureStyle}));this.containerManager.getContainer(e.gameObject.id).addChildAt(r,0),this.texts[e.gameObject.id]={text:r,component:t},o&&(yield this.waitForFontResource(r,e,o))}))}waitForFontResource(e,i,o){return r(this,void 0,void 0,(function*(){if(o)try{const n=Array.isArray(o)?o[0]:o,s=this.increaseAsyncId(i.gameObject.id);if(yield t.resource.getResource(n),!this.validateAsyncId(i.gameObject.id,s))return;const r=this.texts[i.gameObject.id].component;e.style.fontFamily=o,e.text=r.text}catch(e){console.warn(`字体资源 ${o} 加载失败:`,e)}}))}change(e){const{text:t,component:i}=this.texts[e.gameObject.id],o="HTMLText"===e.componentName;if("text"===e.prop.prop[0])t.text=i.text;else if("style"===e.prop.prop[0])Object.assign(t.style,i.style);else if("resolution"!==e.prop.prop[0]||o){if("textureStyle"===e.prop.prop[0]&&o){const o=i,s=this.containerManager.getContainer(e.gameObject.id),r=s.getChildIndex(t);s.removeChild(t),t.destroy({children:!0});const c=new n.HTMLText({text:o.text,style:o.style,textureStyle:o.textureStyle});s.addChildAt(c,r),this.texts[e.gameObject.id].text=c}}else{const e=i;void 0!==e.resolution&&e.resolution>0&&(t.resolution=e.resolution)}}setSize(e){const{transform:t}=e.gameObject;if(!t)return;const{text:i}=this.texts[e.gameObject.id],o=i.getSize();t.size.width=o.width,t.size.height=o.height}};a.systemName="Text",a=s([t.decorators.componentObserver({Text:["text",{prop:["style"],deep:!0},"resolution"],HTMLText:["text",{prop:["style"],deep:!0},{prop:["textureStyle"],deep:!0}]})],a);var d=a;exports.HTMLText=l,exports.Text=c,exports.TextSystem=d;

package/dist/plugin-renderer-text.d.ts

@@ -13,11 +13,83 @@ import { TextStyleFontWeight } from 'pixi.js';
 import { TextStyleTextBaseline } from 'pixi.js';
 import { TextStyleWhiteSpace } from 'pixi.js';
 
+/**
+ * HTML 富文本组件
+ *
+ * HTMLText 组件支持渲染带有 HTML 标签的富文本内容。
+ * 可以在文本中使用 HTML 标签（如 `<b>`, `<i>`, `<span>` 等）来实现丰富的文本样式，
+ * 适用于聊天对话、新闻内容、富文本显示等需要多样式文本的场景。
+ *
+ * 支持的 HTML 标签：
+ * - `<b>` - 粗体
+ * - `<i>` - 斜体
+ * - `<span style="color:#ff0000">` - 自定义样式
+ * - `<br>` - 换行
+ * 以及更多标准 HTML 文本标签
+ *
+ * @example
+ * ```typescript
+ * // 基础富文本
+ * const label = new GameObject('label');
+ * label.addComponent(new HTMLText({
+ *   text: '这是<b>粗体</b>和<i>斜体</i>文本',
+ *   style: {
+ *     fontSize: 24,
+ *     fill: '#000000',
+ *     fontFamily: 'Arial'
+ *   }
+ * }));
+ *
+ * // 带颜色的富文本
+ * label.addComponent(new HTMLText({
+ *   text: '欢迎 <span style="color:#ff0000">玩家123</span> 加入游戏！',
+ *   style: {
+ *     fontSize: 20,
+ *     wordWrap: true,
+ *     wordWrapWidth: 300
+ *   }
+ * }));
+ *
+ * // 自定义标签样式
+ * label.addComponent(new HTMLText({
+ *   text: '获得 <gold>100</gold> 金币',
+ *   style: {
+ *     fontSize: 18,
+ *     tagStyles: {
+ *       gold: {
+ *         fill: '#ffd700',
+ *         fontWeight: 'bold'
+ *       }
+ *     }
+ *   }
+ * }));
+ *
+ * // 高分辨率渲染
+ * label.addComponent(new HTMLText({
+ *   text: '高清文本',
+ *   textureStyle: {
+ *     resolution: 2,
+ *     scaleMode: 'linear'
+ *   }
+ * }));
+ * ```
+ */
 export declare class HTMLText extends Component<HTMLTextParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** 富文本内容（支持 HTML 标签） */
     text: string;
+    /** 文本样式配置 */
     style: HTMLTextParams['style'];
+    /** 纹理渲染配置 */
     textureStyle: HTMLTextParams['textureStyle'];
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.text - 富文本内容
+     * @param obj.style - 文本样式
+     * @param obj.textureStyle - 纹理配置
+     */
     init(obj?: HTMLTextParams): void;
 }
 
@@ -60,10 +132,64 @@ declare interface HTMLTextStyleOptions {
     whiteSpace?: string;
 }
 
+/**
+ * 文本组件（基于 PixiJS Text）
+ *
+ * Text 组件用于渲染文本内容，支持丰富的文本样式配置。
+ * 它基于 PixiJS 的 Text 实现，支持字体、颜色、描边、阴影、对齐等多种样式。
+ *
+ * 主要特性：
+ * - 支持多种字体和字号
+ * - 支持文本颜色、渐变填充
+ * - 支持描边和投影效果
+ * - 支持文本对齐和换行
+ * - 可配置渲染分辨率
+ *
+ * @example
+ * ```typescript
+ * // 基础文本
+ * const label = new GameObject('label');
+ * label.addComponent(new Text({
+ *   text: 'Hello EVA!',
+ *   style: {
+ *     fontSize: 32,
+ *     fill: 0xffffff
+ *   }
+ * }));
+ *
+ * // 带样式的文本
+ * label.addComponent(new Text({
+ *   text: '得分: 9999',
+ *   style: {
+ *     fontFamily: 'Arial',
+ *     fontSize: 48,
+ *     fontWeight: 'bold',
+ *     fill: ['#ff0000', '#ffff00'], // 渐变色
+ *     stroke: '#000000',
+ *     strokeThickness: 4,
+ *     dropShadow: true,
+ *     dropShadowDistance: 3
+ *   },
+ *   resolution: 2 // 高清渲染
+ * }));
+ * ```
+ */
 declare class Text_2 extends Component<TextParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** 文本内容 */
     text: string;
+    /** 文本样式配置 */
     style: TextParams['style'];
+    /** 渲染分辨率，值越大文本越清晰但性能消耗越大 */
+    resolution: number;
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.text - 文本内容
+     * @param obj.style - 文本样式
+     * @param obj.resolution - 渲染分辨率
+     */
     init(obj?: TextParams): void;
 }
 export { Text_2 as Text }
@@ -101,6 +227,7 @@ export declare interface TextParams {
         wordWrapWidth?: number;
         leading?: number;
     };
+    resolution?: number;
 }
 
 export declare class TextSystem extends Renderer {
@@ -119,6 +246,9 @@ export declare class TextSystem extends Renderer {
     componentChanged(changed: ComponentChanged): Promise<void>;
     private addTextComponent;
     private addHTMLTextComponent;
+    /**
+     * 等待字体资源加载完成并更新文本
+     */
     private waitForFontResource;
     change(changed: ComponentChanged): void;
     setSize(changed: ComponentChanged): void;

package/dist/plugin-renderer-text.esm.js

@@ -35,12 +35,66 @@ function __awaiter(thisArg, _arguments, P, generator) {
     });
 }
 
+/**
+ * 文本组件（基于 PixiJS Text）
+ *
+ * Text 组件用于渲染文本内容，支持丰富的文本样式配置。
+ * 它基于 PixiJS 的 Text 实现，支持字体、颜色、描边、阴影、对齐等多种样式。
+ *
+ * 主要特性：
+ * - 支持多种字体和字号
+ * - 支持文本颜色、渐变填充
+ * - 支持描边和投影效果
+ * - 支持文本对齐和换行
+ * - 可配置渲染分辨率
+ *
+ * @example
+ * ```typescript
+ * // 基础文本
+ * const label = new GameObject('label');
+ * label.addComponent(new Text({
+ *   text: 'Hello EVA!',
+ *   style: {
+ *     fontSize: 32,
+ *     fill: 0xffffff
+ *   }
+ * }));
+ *
+ * // 带样式的文本
+ * label.addComponent(new Text({
+ *   text: '得分: 9999',
+ *   style: {
+ *     fontFamily: 'Arial',
+ *     fontSize: 48,
+ *     fontWeight: 'bold',
+ *     fill: ['#ff0000', '#ffff00'], // 渐变色
+ *     stroke: '#000000',
+ *     strokeThickness: 4,
+ *     dropShadow: true,
+ *     dropShadowDistance: 3
+ *   },
+ *   resolution: 2 // 高清渲染
+ * }));
+ * ```
+ */
 class Text$2 extends Component {
     constructor() {
         super(...arguments);
+        /** 文本内容 */
         this.text = '';
+        /** 文本样式配置 */
+        // @decorators.IDEProp 复杂编辑后续添加
         this.style = {};
+        /** 渲染分辨率，值越大文本越清晰但性能消耗越大 */
+        this.resolution = 1;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.text - 文本内容
+     * @param obj.style - 文本样式
+     * @param obj.resolution - 渲染分辨率
+     */
     init(obj) {
         const style = new TextStyle({
             fontSize: 20,
@@ -56,21 +110,99 @@ class Text$2 extends Component {
         if (obj) {
             this.text = obj.text;
             Object.assign(this.style, obj.style);
+            if (obj.resolution !== undefined) {
+                this.resolution = obj.resolution;
+            }
         }
     }
 }
+/** 组件名称 */
 Text$2.componentName = 'Text';
 __decorate([
     type('string')
-], Text$2.prototype, "text", void 0);
+], Text$2.prototype, "text", void 0);
+__decorate([
+    type('number')
+], Text$2.prototype, "resolution", void 0);
 
+/**
+ * HTML 富文本组件
+ *
+ * HTMLText 组件支持渲染带有 HTML 标签的富文本内容。
+ * 可以在文本中使用 HTML 标签（如 `<b>`, `<i>`, `<span>` 等）来实现丰富的文本样式，
+ * 适用于聊天对话、新闻内容、富文本显示等需要多样式文本的场景。
+ *
+ * 支持的 HTML 标签：
+ * - `<b>` - 粗体
+ * - `<i>` - 斜体
+ * - `<span style="color:#ff0000">` - 自定义样式
+ * - `<br>` - 换行
+ * 以及更多标准 HTML 文本标签
+ *
+ * @example
+ * ```typescript
+ * // 基础富文本
+ * const label = new GameObject('label');
+ * label.addComponent(new HTMLText({
+ *   text: '这是<b>粗体</b>和<i>斜体</i>文本',
+ *   style: {
+ *     fontSize: 24,
+ *     fill: '#000000',
+ *     fontFamily: 'Arial'
+ *   }
+ * }));
+ *
+ * // 带颜色的富文本
+ * label.addComponent(new HTMLText({
+ *   text: '欢迎 <span style="color:#ff0000">玩家123</span> 加入游戏！',
+ *   style: {
+ *     fontSize: 20,
+ *     wordWrap: true,
+ *     wordWrapWidth: 300
+ *   }
+ * }));
+ *
+ * // 自定义标签样式
+ * label.addComponent(new HTMLText({
+ *   text: '获得 <gold>100</gold> 金币',
+ *   style: {
+ *     fontSize: 18,
+ *     tagStyles: {
+ *       gold: {
+ *         fill: '#ffd700',
+ *         fontWeight: 'bold'
+ *       }
+ *     }
+ *   }
+ * }));
+ *
+ * // 高分辨率渲染
+ * label.addComponent(new HTMLText({
+ *   text: '高清文本',
+ *   textureStyle: {
+ *     resolution: 2,
+ *     scaleMode: 'linear'
+ *   }
+ * }));
+ * ```
+ */
 class HTMLText extends Component {
     constructor() {
         super(...arguments);
+        /** 富文本内容（支持 HTML 标签） */
         this.text = '';
+        /** 文本样式配置 */
         this.style = {};
+        /** 纹理渲染配置 */
         this.textureStyle = {};
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.text - 富文本内容
+     * @param obj.style - 文本样式
+     * @param obj.textureStyle - 纹理配置
+     */
     init(obj) {
         this.style = Object.assign({ fontSize: 24, fill: '#000000', fontFamily: 'Arial' }, obj === null || obj === void 0 ? void 0 : obj.style);
         this.textureStyle = Object.assign({ scaleMode: 'linear', resolution: window.devicePixelRatio || 1 }, obj === null || obj === void 0 ? void 0 : obj.textureStyle);
@@ -79,6 +211,7 @@ class HTMLText extends Component {
         }
     }
 }
+/** 组件名称 */
 HTMLText.componentName = 'HTMLText';
 __decorate([
     type('string')
@@ -116,6 +249,7 @@ let Text = class Text extends Renderer {
             }
             else {
                 this.change(changed);
+                // 如果样式改变且涉及字体，也需要等待字体资源加载
                 const component = changed.component;
                 if (changed.prop.prop[0] === 'style' && component.style && component.style.fontFamily) {
                     const { text } = this.texts[changed.gameObject.id];
@@ -128,16 +262,22 @@ let Text = class Text extends Renderer {
     addTextComponent(changed) {
         return __awaiter(this, void 0, void 0, function* () {
             const component = changed.component;
+            // 创建文本样式副本，先不设置 fontFamily
             const styleWithoutFont = Object.assign({}, component.style);
             const fontFamily = styleWithoutFont.fontFamily;
             delete styleWithoutFont.fontFamily;
             const initialText = fontFamily ? '' : component.text;
             const text = new Text$3(initialText, styleWithoutFont);
+            // 设置 resolution 以提升清晰度
+            if (component.resolution !== undefined && component.resolution > 0) {
+                text.resolution = component.resolution;
+            }
             this.containerManager.getContainer(changed.gameObject.id).addChildAt(text, 0);
             this.texts[changed.gameObject.id] = {
                 text,
                 component,
             };
+            // 如果指定了字体资源，等待资源加载完成后设置 fontFamily
             if (fontFamily) {
                 yield this.waitForFontResource(text, changed, fontFamily);
             }
@@ -146,6 +286,7 @@ let Text = class Text extends Renderer {
     addHTMLTextComponent(changed) {
         return __awaiter(this, void 0, void 0, function* () {
             const component = changed.component;
+            // 创建样式副本，先不设置 fontFamily
             const styleWithoutFont = Object.assign({}, component.style);
             const fontFamily = styleWithoutFont.fontFamily;
             delete styleWithoutFont.fontFamily;
@@ -156,11 +297,15 @@ let Text = class Text extends Renderer {
                 text: htmlText,
                 component,
             };
+            // 如果指定了字体资源，等待资源加载完成后设置 fontFamily
             if (fontFamily) {
                 yield this.waitForFontResource(htmlText, changed, fontFamily);
             }
         });
     }
+    /**
+     * 等待字体资源加载完成并更新文本
+     */
     waitForFontResource(text, changed, fontFamily) {
         return __awaiter(this, void 0, void 0, function* () {
             if (!fontFamily) {
@@ -168,13 +313,17 @@ let Text = class Text extends Renderer {
             }
             try {
                 const fontName = Array.isArray(fontFamily) ? fontFamily[0] : fontFamily;
+                // 通过 resource 系统获取字体资源
                 const asyncId = this.increaseAsyncId(changed.gameObject.id);
                 yield resource.getResource(fontName);
+                // 验证异步操作是否仍然有效（防止组件已被移除）
                 if (!this.validateAsyncId(changed.gameObject.id, asyncId))
                     return;
+                // 字体资源加载成功后，设置 fontFamily 并重新设置文本内容以触发重新渲染
                 const component = this.texts[changed.gameObject.id].component;
                 text.style.fontFamily = fontFamily;
                 text.text = component.text;
+                // 更新尺寸
             }
             catch (error) {
                 console.warn(`字体资源 ${fontFamily} 加载失败:`, error);
@@ -190,7 +339,15 @@ let Text = class Text extends Renderer {
         else if (changed.prop.prop[0] === 'style') {
             Object.assign(text.style, component.style);
         }
+        else if (changed.prop.prop[0] === 'resolution' && !isHTMLText) {
+            // 更新 resolution
+            const textComponent = component;
+            if (textComponent.resolution !== undefined && textComponent.resolution > 0) {
+                text.resolution = textComponent.resolution;
+            }
+        }
         else if (changed.prop.prop[0] === 'textureStyle' && isHTMLText) {
+            // HTMLText 纹理样式变化需要重新创建
             const htmlComponent = component;
             const container = this.containerManager.getContainer(changed.gameObject.id);
             const index = container.getChildIndex(text);
@@ -218,7 +375,7 @@ let Text = class Text extends Renderer {
 Text.systemName = 'Text';
 Text = __decorate([
     decorators.componentObserver({
-        Text: ['text', { prop: ['style'], deep: true }],
+        Text: ['text', { prop: ['style'], deep: true }, 'resolution'],
         HTMLText: ['text', { prop: ['style'], deep: true }, { prop: ['textureStyle'], deep: true }],
     })
 ], Text);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eva/plugin-renderer-text",
-  "version": "2.0.1-beta.26",
+  "version": "2.0.1-beta.28",
   "description": "@eva/plugin-renderer-text",
   "main": "index.js",
   "module": "dist/plugin-renderer-text.esm.js",
@@ -19,9 +19,9 @@
   "homepage": "https://eva.js.org",
   "dependencies": {
     "@eva/inspector-decorator": "^0.0.5",
-    "@eva/plugin-renderer": "2.0.1-beta.26",
-    "@eva/renderer-adapter": "2.0.1-beta.26",
-    "@eva/eva.js": "2.0.1-beta.26",
+    "@eva/plugin-renderer": "2.0.1-beta.28",
+    "@eva/renderer-adapter": "2.0.1-beta.28",
+    "@eva/eva.js": "2.0.1-beta.28",
     "pixi.js": "^8.8.1"
   }
 }