@eva/plugin-renderer-text 2.1.0-beta.3 → 2.1.0-beta.4

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

@@ -0,0 +1,864 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var eva_js = require('@eva/eva.js');
+var pixi_js = require('pixi.js');
+var pluginRenderer = require('@eva/plugin-renderer');
+var rendererAdapter = require('@eva/renderer-adapter');
+
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
+
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
+
+THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES WITH
+REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
+AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY SPECIAL, DIRECT,
+INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
+LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, NEGLIGENCE OR
+OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION WITH THE USE OR
+PERFORMANCE OF THIS SOFTWARE.
+***************************************************************************** */
+
+function __decorate(decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+}
+
+function __metadata(metadataKey, metadataValue) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(metadataKey, metadataValue);
+}
+
+function __awaiter(thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+class BitmapTextStyleMetadata {
+}
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", Object)
+], BitmapTextStyleMetadata.prototype, "fontFamily", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Object)
+], BitmapTextStyleMetadata.prototype, "fontSize", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], BitmapTextStyleMetadata.prototype, "fill", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], BitmapTextStyleMetadata.prototype, "align", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], BitmapTextStyleMetadata.prototype, "letterSpacing", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], BitmapTextStyleMetadata.prototype, "padding", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], BitmapTextStyleMetadata.prototype, "stroke", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], BitmapTextStyleMetadata.prototype, "strokeThickness", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], BitmapTextStyleMetadata.prototype, "fontWeight", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], BitmapTextStyleMetadata.prototype, "fontStyle", void 0);
+/**
+ * 位图文本组件
+ *
+ * BitmapText 组件使用位图字体渲染文本，性能优于 Canvas 文本渲染。
+ * 适用于频繁更新的文本场景，如计分板、倒计时等。
+ *
+ * 支持两种字体模式：
+ * - 动态生成：指定 TextStyle，PixiJS 自动生成 bitmap font
+ * - 预加载字体：通过 BitmapFont.install() 预安装或从 .fnt 文件加载
+ *
+ * @example
+ * ```typescript
+ * const score = new GameObject('score');
+ * score.addComponent(new BitmapText({
+ *   text: 'Score: 0',
+ *   style: {
+ *     fontSize: 32,
+ *     fill: '#ffffff',
+ *     fontFamily: 'Arial'
+ *   }
+ * }));
+ * ```
+ */
+class BitmapText extends eva_js.Component {
+    constructor() {
+        super(...arguments);
+        this.text = '';
+        this.style = {};
+    }
+    init(obj) {
+        this.style = Object.assign({ fontSize: 24, fill: '#000000', fontFamily: 'Arial' }, obj === null || obj === void 0 ? void 0 : obj.style);
+        if (obj) {
+            this.text = obj.text;
+        }
+    }
+}
+BitmapText.componentName = 'BitmapText';
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], BitmapText.prototype, "text", void 0);
+__decorate([
+    eva_js.Field(() => BitmapTextStyleMetadata),
+    __metadata("design:type", Object)
+], BitmapText.prototype, "style", void 0);
+
+class TextStyleStrokeMetadata {
+}
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleStrokeMetadata.prototype, "alpha", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], TextStyleStrokeMetadata.prototype, "color", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleStrokeMetadata.prototype, "join", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleStrokeMetadata.prototype, "miterLimit", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleStrokeMetadata.prototype, "width", void 0);
+class TextStyleDropShadowMetadata {
+}
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleDropShadowMetadata.prototype, "alpha", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleDropShadowMetadata.prototype, "angle", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleDropShadowMetadata.prototype, "blur", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], TextStyleDropShadowMetadata.prototype, "color", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleDropShadowMetadata.prototype, "distance", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], TextStyleDropShadowMetadata.prototype, "enabled", void 0);
+class TextStyleMetadata {
+}
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "align", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], TextStyleMetadata.prototype, "breakWords", void 0);
+__decorate([
+    eva_js.Field(() => TextStyleDropShadowMetadata),
+    __metadata("design:type", Object)
+], TextStyleMetadata.prototype, "dropShadow", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "dropShadowAlpha", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "dropShadowAngle", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "dropShadowBlur", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], TextStyleMetadata.prototype, "dropShadowColor", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "dropShadowDistance", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], TextStyleMetadata.prototype, "fill", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "fillGradientType", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Array)
+], TextStyleMetadata.prototype, "fillGradientStops", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", Object)
+], TextStyleMetadata.prototype, "fontFamily", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Object)
+], TextStyleMetadata.prototype, "fontSize", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "fontStyle", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "fontVariant", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "fontWeight", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "leading", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "letterSpacing", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "lineHeight", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "lineJoin", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "miterLimit", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "padding", void 0);
+__decorate([
+    eva_js.Field(() => TextStyleStrokeMetadata),
+    __metadata("design:type", Object)
+], TextStyleMetadata.prototype, "stroke", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "strokeThickness", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "textBaseline", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "verticalAlign", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], TextStyleMetadata.prototype, "trim", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], TextStyleMetadata.prototype, "whiteSpace", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], TextStyleMetadata.prototype, "wordWrap", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], TextStyleMetadata.prototype, "wordWrapWidth", void 0);
+/**
+ * 文本组件（基于 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
+ *   }
+ * }));
+ * // 如需高清渲染，使用 Render 组件的 resolution 属性
+ * label.addComponent(new Render({ resolution: 2 }));
+ * ```
+ */
+class Text$2 extends eva_js.Component {
+    constructor(params) {
+        super(params);
+        /** 文本内容 */
+        this.text = '';
+        /** 文本样式配置 */
+        this.style = {};
+        this.init(params);
+    }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     */
+    init(obj) {
+        const style = new pixi_js.TextStyle({
+            fontSize: 20,
+        });
+        const newStyle = {};
+        for (const key in style) {
+            if (key.indexOf('_') === 0) {
+                newStyle[key.substring(1)] = style[key];
+            }
+        }
+        delete newStyle['styleKey'];
+        this.style = newStyle;
+        if (obj) {
+            this.text = obj.text;
+            Object.assign(this.style, obj.style);
+        }
+    }
+}
+/** 组件名称 */
+Text$2.componentName = 'Text';
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], Text$2.prototype, "text", void 0);
+__decorate([
+    eva_js.Field(() => TextStyleMetadata),
+    __metadata("design:type", Object)
+], Text$2.prototype, "style", void 0);
+
+class HTMLTextTextureStyleMetadata {
+}
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextTextureStyleMetadata.prototype, "scaleMode", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextTextureStyleMetadata.prototype, "resolution", void 0);
+class HTMLTextStyleMetadata {
+}
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", Object)
+], HTMLTextStyleMetadata.prototype, "fontFamily", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Object)
+], HTMLTextStyleMetadata.prototype, "fontSize", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextStyleMetadata.prototype, "fontWeight", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextStyleMetadata.prototype, "fontStyle", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextStyleMetadata.prototype, "fontVariant", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextStyleMetadata.prototype, "align", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextStyleMetadata.prototype, "textBaseline", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], HTMLTextStyleMetadata.prototype, "fill", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], HTMLTextStyleMetadata.prototype, "stroke", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "strokeThickness", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "lineHeight", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "letterSpacing", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "padding", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], HTMLTextStyleMetadata.prototype, "wordWrap", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "wordWrapWidth", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], HTMLTextStyleMetadata.prototype, "breakWords", void 0);
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLTextStyleMetadata.prototype, "whiteSpace", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], HTMLTextStyleMetadata.prototype, "dropShadow", void 0);
+__decorate([
+    eva_js.Field({ type: 'color' }),
+    __metadata("design:type", Object)
+], HTMLTextStyleMetadata.prototype, "dropShadowColor", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "dropShadowAlpha", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "dropShadowAngle", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "dropShadowBlur", void 0);
+__decorate([
+    eva_js.type('number'),
+    __metadata("design:type", Number)
+], HTMLTextStyleMetadata.prototype, "dropShadowDistance", void 0);
+__decorate([
+    eva_js.type('object'),
+    __metadata("design:type", Array)
+], HTMLTextStyleMetadata.prototype, "cssOverrides", void 0);
+__decorate([
+    eva_js.type('object'),
+    __metadata("design:type", Object)
+], HTMLTextStyleMetadata.prototype, "tagStyles", void 0);
+__decorate([
+    eva_js.type('boolean'),
+    __metadata("design:type", Boolean)
+], HTMLTextStyleMetadata.prototype, "trim", 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'
+ *       }
+ *     }
+ *   }
+ * }));
+ *
+ * // 高分辨率渲染（推荐使用 Render 组件的 resolution 属性）
+ * label.addComponent(new HTMLText({
+ *   text: '高清文本',
+ *   textureStyle: {
+ *     scaleMode: 'linear'
+ *   }
+ * }));
+ * label.addComponent(new Render({ resolution: 2 }));
+ * ```
+ */
+class HTMLText extends eva_js.Component {
+    constructor() {
+        super(...arguments);
+        /** 富文本内容（支持 HTML 标签） */
+        this.text = '';
+        /** 文本样式配置 */
+        this.style = {};
+        /** 纹理渲染配置 */
+        this.textureStyle = {};
+    }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     */
+    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);
+        if (obj) {
+            this.text = obj.text;
+        }
+    }
+}
+/** 组件名称 */
+HTMLText.componentName = 'HTMLText';
+__decorate([
+    eva_js.type('string'),
+    __metadata("design:type", String)
+], HTMLText.prototype, "text", void 0);
+__decorate([
+    eva_js.Field(() => HTMLTextStyleMetadata),
+    __metadata("design:type", Object)
+], HTMLText.prototype, "style", void 0);
+__decorate([
+    eva_js.Field(() => HTMLTextTextureStyleMetadata),
+    __metadata("design:type", Object)
+], HTMLText.prototype, "textureStyle", void 0);
+
+let Text = class Text extends pluginRenderer.Renderer {
+    constructor() {
+        super(...arguments);
+        this.name = 'Text';
+        this.texts = {};
+    }
+    init() {
+        this.renderSystem = this.game.getSystem(pluginRenderer.RendererSystem);
+        this.renderSystem.rendererManager.register(this);
+    }
+    componentChanged(changed) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const isText = changed.componentName === 'Text';
+            const isHTMLText = changed.componentName === 'HTMLText';
+            const isBitmapText = changed.componentName === 'BitmapText';
+            if (!isText && !isHTMLText && !isBitmapText)
+                return;
+            if (changed.type === eva_js.OBSERVER_TYPE.ADD) {
+                if (isText) {
+                    yield this.addTextComponent(changed);
+                }
+                else if (isHTMLText) {
+                    yield this.addHTMLTextComponent(changed);
+                }
+                else {
+                    yield this.addBitmapTextComponent(changed);
+                }
+                this.setSize(changed);
+            }
+            else if (changed.type === eva_js.OBSERVER_TYPE.REMOVE) {
+                this.containerManager.getContainer(changed.gameObject.id).removeChild(this.texts[changed.gameObject.id].text);
+                this.texts[changed.gameObject.id].text.destroy({ children: true });
+                delete this.texts[changed.gameObject.id];
+            }
+            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];
+                    yield this.waitForFontResource(text, changed, component.style.fontFamily);
+                }
+                this.setSize(changed);
+            }
+        });
+    }
+    addTextComponent(changed) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const component = changed.component;
+            // 创建文本样式副本，先不设置 fontFamily
+            const styleWithoutFont = this.processStyle(component.style);
+            const fontFamily = styleWithoutFont.fontFamily;
+            delete styleWithoutFont.fontFamily;
+            const initialText = fontFamily ? '' : component.text;
+            const text = new rendererAdapter.Text(initialText, styleWithoutFont);
+            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);
+            }
+        });
+    }
+    addHTMLTextComponent(changed) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const component = changed.component;
+            // 创建样式副本，先不设置 fontFamily
+            const styleWithoutFont = this.processStyle(component.style);
+            const fontFamily = styleWithoutFont.fontFamily;
+            delete styleWithoutFont.fontFamily;
+            const initialText = fontFamily ? '' : component.text;
+            const htmlText = new rendererAdapter.HTMLText(Object.assign({ text: initialText, style: styleWithoutFont }, (component.textureStyle && { textureStyle: component.textureStyle })));
+            this.containerManager.getContainer(changed.gameObject.id).addChildAt(htmlText, 0);
+            this.texts[changed.gameObject.id] = {
+                text: htmlText,
+                component,
+            };
+            // 如果指定了字体资源，等待资源加载完成后设置 fontFamily
+            if (fontFamily) {
+                yield this.waitForFontResource(htmlText, changed, fontFamily);
+            }
+        });
+    }
+    addBitmapTextComponent(changed) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const component = changed.component;
+            // 创建样式副本，先不设置 fontFamily
+            const styleWithoutFont = this.processStyle(component.style);
+            const fontFamily = styleWithoutFont.fontFamily;
+            delete styleWithoutFont.fontFamily;
+            const initialText = fontFamily ? '' : component.text;
+            const bitmapText = new rendererAdapter.BitmapText(initialText, styleWithoutFont);
+            this.containerManager.getContainer(changed.gameObject.id).addChildAt(bitmapText, 0);
+            this.texts[changed.gameObject.id] = {
+                text: bitmapText,
+                component,
+            };
+            // 如果指定了字体资源，等待资源加载完成后设置 fontFamily
+            if (fontFamily) {
+                yield this.waitForFontResource(bitmapText, changed, fontFamily);
+            }
+        });
+    }
+    /**
+     * 等待字体资源加载完成并更新文本
+     */
+    waitForFontResource(text, changed, fontFamily) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (!fontFamily) {
+                return;
+            }
+            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);
+            }
+        });
+    }
+    /**
+     * 将 Eva.js 的样式格式转换为 PixiJS v8 格式
+     */
+    processStyle(style) {
+        const processed = Object.assign({}, style);
+        // stroke + strokeThickness -> stroke: { color, width }
+        if (processed.strokeThickness) {
+            const color = processed.stroke;
+            processed.stroke = {
+                color,
+                width: processed.strokeThickness,
+            };
+            delete processed.strokeThickness;
+        }
+        // dropShadow*(v7 平铺 alias) -> dropShadow: { color, distance, angle, alpha, blur }
+        // 关键:只有当存在任何 v7 平铺 alias 时才合并;否则保留 v8 嵌套对象(以及
+        // dropShadow: true / false 这种纯开关)原样透传。否则上一种情况会用空对象
+        // 把 DSL 已经写好的 angle/blur/distance/... 整个覆盖。
+        const hasFlatDropShadowAlias = processed.dropShadowColor != null ||
+            processed.dropShadowDistance != null ||
+            processed.dropShadowAngle != null ||
+            processed.dropShadowAlpha != null ||
+            processed.dropShadowBlur != null;
+        if (processed.dropShadow && hasFlatDropShadowAlias) {
+            const base = processed.dropShadow && typeof processed.dropShadow === 'object' && !Array.isArray(processed.dropShadow)
+                ? Object.assign({}, processed.dropShadow) : {};
+            if (processed.dropShadowColor != null) {
+                base.color = processed.dropShadowColor;
+            }
+            if (processed.dropShadowDistance != null) {
+                base.distance = processed.dropShadowDistance;
+            }
+            if (processed.dropShadowAngle != null) {
+                base.angle = processed.dropShadowAngle;
+            }
+            if (processed.dropShadowAlpha != null) {
+                base.alpha = processed.dropShadowAlpha;
+            }
+            if (processed.dropShadowBlur != null) {
+                base.blur = processed.dropShadowBlur;
+            }
+            processed.dropShadow = base;
+        }
+        delete processed.dropShadowColor;
+        delete processed.dropShadowDistance;
+        delete processed.dropShadowAngle;
+        delete processed.dropShadowAlpha;
+        delete processed.dropShadowBlur;
+        // fill 数组 -> 取第一个值 (deprecated)
+        if (Array.isArray(processed.fill)) {
+            processed.fill = processed.fill[0];
+        }
+        // fillGradientStops -> FillGradient 对象
+        if (Array.isArray(processed.fillGradientStops)) {
+            let fontSize;
+            if (processed.fontSize == null) {
+                fontSize = pixi_js.TextStyle.defaultTextStyle.fontSize;
+            }
+            else if (typeof processed.fontSize === 'string') {
+                fontSize = parseInt(processed.fontSize, 10);
+            }
+            else {
+                fontSize = processed.fontSize;
+            }
+            const gradientFill = new pixi_js.FillGradient(0, 0, 0, fontSize * 1.7);
+            const fills = processed.fillGradientStops.map((color) => pixi_js.Color.shared.setValue(color).toNumber());
+            fills.forEach((number, index) => {
+                const ratio = index / (fills.length - 1);
+                gradientFill.addColorStop(ratio, number);
+            });
+            processed.fill = { fill: gradientFill };
+            delete processed.fillGradientStops;
+        }
+        return processed;
+    }
+    change(changed) {
+        const { text, component } = this.texts[changed.gameObject.id];
+        const isHTMLText = changed.componentName === 'HTMLText';
+        if (changed.prop.prop[0] === 'text') {
+            text.text = component.text;
+        }
+        else if (changed.prop.prop[0] === 'style') {
+            const processedStyle = this.processStyle(component.style);
+            Object.assign(text.style, processedStyle);
+        }
+        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);
+            container.removeChild(text);
+            text.destroy({ children: true });
+            const newText = new rendererAdapter.HTMLText({
+                text: htmlComponent.text,
+                style: htmlComponent.style,
+                textureStyle: htmlComponent.textureStyle,
+            });
+            container.addChildAt(newText, index);
+            this.texts[changed.gameObject.id].text = newText;
+        }
+    }
+    setSize(changed) {
+        const { transform } = changed.gameObject;
+        if (!transform)
+            return;
+        const { text } = this.texts[changed.gameObject.id];
+        const size = text.getSize();
+        transform.size.width = size.width;
+        transform.size.height = size.height;
+    }
+};
+Text.systemName = 'Text';
+Text = __decorate([
+    eva_js.decorators.componentObserver({
+        Text: ['text', { prop: ['style'], deep: true }],
+        HTMLText: ['text', { prop: ['style'], deep: true }, { prop: ['textureStyle'], deep: true }],
+        BitmapText: ['text', { prop: ['style'], deep: true }],
+    })
+], Text);
+var Text$1 = Text;
+
+exports.BitmapText = BitmapText;
+exports.HTMLText = HTMLText;
+exports.Text = Text$2;
+exports.TextSystem = Text$1;