@eva/plugin-renderer-nine-patch 2.0.1-beta.9 → 2.0.2-beta.0

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

@@ -1 +1 @@
-globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_ninePatch=function(e,t,i,r){"use strict";function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))((function(n,o){function s(e){try{h(r.next(e))}catch(e){o(e)}}function c(e){try{h(r.throw(e))}catch(e){o(e)}}function h(e){var t;e.done?n(e.value):(t=e.value,t instanceof i?t:new i((function(e){e(t)}))).then(s,c)}h((r=r.apply(e,t||[])).next())}))}function s(e,t){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[t]||(e.constructor.IDEProps[t]={}),e.constructor.IDEProps[t]}function c(e){return function(t,i){var r=s(t,i);r.key=i,r.type=e}}function h(e){return function(t,i){s(t,i).step=e}}class a extends t.Component{constructor(){super(...arguments),this.resource="",this.spriteName="",this.leftWidth=0,this.topHeight=0,this.rightWidth=0,this.bottomHeight=0}init(e){this.resource=e.resource,this.spriteName=e.spriteName,this.leftWidth=e.leftWidth,this.topHeight=e.topHeight,this.rightWidth=e.rightWidth,this.bottomHeight=e.bottomHeight}}a.componentName="NinePatch",n([c("string")],a.prototype,"resource",void 0),n([c("string")],a.prototype,"spriteName",void 0),n([c("number"),h(1)],a.prototype,"leftWidth",void 0),n([c("number"),h(1)],a.prototype,"topHeight",void 0),n([c("number"),h(1)],a.prototype,"rightWidth",void 0),n([c("number"),h(1)],a.prototype,"bottomHeight",void 0);let d=class extends i.Renderer{constructor(){super(...arguments),this.name="NinePatch",this.ninePatch={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size;this.ninePatch[e.id]&&(this.ninePatch[e.id].width=t,this.ninePatch[e.id].height=i)}componentChanged(e){return o(this,void 0,void 0,(function*(){"NinePatch"===e.componentName&&(e.type===t.OBSERVER_TYPE.ADD?this.add(e):e.type===t.OBSERVER_TYPE.REMOVE?this.remove(e):(this.remove(e),this.add(e)))}))}add(e){return o(this,void 0,void 0,(function*(){const i=e.component,n=e.gameObject.id,o=this.increaseAsyncId(n),{type:s,data:c,instance:h}=yield t.resource.getResource(i.resource);if(!this.validateAsyncId(n,o))return;if(!c)return void console.error(`GameObject:${e.gameObject.name}'s NinePatch resource load error`);let a;if(s===t.RESOURCE_TYPE.SPRITE&&i.spriteName){if(!h)return void console.error("GameObjectNinePatch Sprite resource rely on the Sprite system");a=h[i.resource+"_s|r|c_"+i.spriteName]}else a=c.image;const{leftWidth:d,topHeight:u,rightWidth:p,bottomHeight:g}=i,l=new r.NinePatch(a,d,u,p,g);this.ninePatch[e.gameObject.id]=l,i.ninePatch=l,this.containerManager.getContainer(e.gameObject.id).addChildAt(l,0)}))}remove(e){const t=e.gameObject.id;this.increaseAsyncId(t);const i=this.ninePatch[t];i&&(this.containerManager.getContainer(e.gameObject.id).removeChild(i),delete this.ninePatch[e.gameObject.id],i.destroy({children:!0}))}};d.systemName="NinePatch",d=n([t.decorators.componentObserver({NinePatch:["resource","spriteName","leftWidth","topHeight","rightWidth","bottomHeight"]})],d);var u=d;return e.NinePatch=a,e.NinePatchSystem=u,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,EVA.rendererAdapter);globalThis.EVA.plugin.renderer.ninePatch=globalThis.EVA.plugin.renderer.ninePatch||_EVA_IIFE_ninePatch;
+globalThis.EVA=globalThis.EVA||{},globalThis.EVA.plugin=globalThis.EVA.plugin||{},globalThis.EVA.plugin.renderer=globalThis.EVA.plugin.renderer||{};var _EVA_IIFE_ninePatch=function(e,t,i,r){"use strict";function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var c=e.length-1;c>=0;c--)(n=e[c])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))(function(n,o){function s(e){try{h(r.next(e))}catch(e){o(e)}}function c(e){try{h(r.throw(e))}catch(e){o(e)}}function h(e){var t;e.done?n(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(s,c)}h((r=r.apply(e,t||[])).next())})}function s(e,t){return e.constructor.IDEProps||(e.constructor.IDEProps={}),e.constructor.IDEProps[t]||(e.constructor.IDEProps[t]={}),e.constructor.IDEProps[t]}function c(e){return function(t,i){var r=s(t,i);r.key=i,r.type=e}}function h(e){return function(t,i){s(t,i).step=e}}class a extends t.Component{constructor(){super(...arguments),this.resource="",this.spriteName="",this.leftWidth=0,this.topHeight=0,this.rightWidth=0,this.bottomHeight=0}init(e){this.resource=e.resource,this.spriteName=e.spriteName,this.leftWidth=e.leftWidth,this.topHeight=e.topHeight,this.rightWidth=e.rightWidth,this.bottomHeight=e.bottomHeight}}a.componentName="NinePatch",n([c("string")],a.prototype,"resource",void 0),n([c("string")],a.prototype,"spriteName",void 0),n([c("number"),h(1)],a.prototype,"leftWidth",void 0),n([c("number"),h(1)],a.prototype,"topHeight",void 0),n([c("number"),h(1)],a.prototype,"rightWidth",void 0),n([c("number"),h(1)],a.prototype,"bottomHeight",void 0);let d=class extends i.Renderer{constructor(){super(...arguments),this.name="NinePatch",this.ninePatch={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size;this.ninePatch[e.id]&&(this.ninePatch[e.id].width=t,this.ninePatch[e.id].height=i)}componentChanged(e){return o(this,void 0,void 0,function*(){"NinePatch"===e.componentName&&(e.type===t.OBSERVER_TYPE.ADD?this.add(e):e.type===t.OBSERVER_TYPE.REMOVE?this.remove(e):(this.remove(e),this.add(e)))})}add(e){return o(this,void 0,void 0,function*(){const i=e.component,n=e.gameObject.id,o=this.increaseAsyncId(n),{type:s,data:c,instance:h}=yield t.resource.getResource(i.resource);if(!this.validateAsyncId(n,o))return;if(!c)return void console.error(`GameObject:${e.gameObject.name}'s NinePatch resource load error`);let a;if(s===t.RESOURCE_TYPE.SPRITE&&i.spriteName){if(!h)return void console.error("GameObjectNinePatch Sprite resource rely on the Sprite system");a=h[i.resource+"_s|r|c_"+i.spriteName]}else a=c.image;const{leftWidth:d,topHeight:u,rightWidth:p,bottomHeight:g}=i,l=new r.NinePatch(a,d,u,p,g);this.ninePatch[e.gameObject.id]=l,i.ninePatch=l,this.containerManager.getContainer(e.gameObject.id).addChildAt(l,0)})}remove(e){const t=e.gameObject.id;this.increaseAsyncId(t);const i=this.ninePatch[t];i&&(this.containerManager.getContainer(e.gameObject.id).removeChild(i),delete this.ninePatch[e.gameObject.id],i.destroy({children:!0}))}};d.systemName="NinePatch",d=n([t.decorators.componentObserver({NinePatch:["resource","spriteName","leftWidth","topHeight","rightWidth","bottomHeight"]})],d);var u=d;return e.NinePatch=a,e.NinePatchSystem=u,Object.defineProperty(e,"__esModule",{value:!0}),e}({},EVA,EVA.plugin.renderer,EVA.rendererAdapter);globalThis.EVA.plugin.renderer.ninePatch=globalThis.EVA.plugin.renderer.ninePatch||_EVA_IIFE_ninePatch;

package/dist/plugin-renderer-nine-patch.cjs.js

@@ -7,19 +7,19 @@ var inspectorDecorator = require('@eva/inspector-decorator');
 var pluginRenderer = require('@eva/plugin-renderer');
 var rendererAdapter = 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
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
 
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
 
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
+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) {
@@ -30,24 +30,93 @@ function __decorate(decorators, target, key, desc) {
 }
 
 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) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        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;
+};
 
+/**
+ * 九宫格组件
+ *
+ * NinePatch 组件用于实现可拉伸的图片，保持边角不变形。
+ * 将图片分为 9 个区域，拉伸时只拉伸中间区域，边角保持原始比例，
+ * 适用于按钮、对话框、面板等需要自适应尺寸的 UI 元素。
+ *
+ * 九宫格原理：
+ * ```
+ * +-------+-------+-------+
+ * | 左上  |  上   | 右上  |
+ * +-------+-------+-------+
+ * |  左   | 中间  |  右   |
+ * +-------+-------+-------+
+ * | 左下  |  下   | 右下  |
+ * +-------+-------+-------+
+ * ```
+ * 拉伸时，四个角保持不变，四条边单向拉伸，中间区域双向拉伸。
+ *
+ * @example
+ * ```typescript
+ * // 创建可拉伸的按钮背景
+ * const button = new GameObject('button');
+ * button.addComponent(new NinePatch({
+ *   resource: 'buttonBg', // 按钮背景资源
+ *   spriteName: 'btn_normal.png',
+ *   leftWidth: 20,   // 左边不拉伸区域宽度
+ *   topHeight: 20,   // 顶部不拉伸区域高度
+ *   rightWidth: 20,  // 右边不拉伸区域宽度
+ *   bottomHeight: 20 // 底部不拉伸区域高度
+ * }));
+ *
+ * // 设置按钮尺寸（自动拉伸）
+ * button.transform.size = { width: 200, height: 60 };
+ *
+ * // 创建对话框背景
+ * const dialog = new GameObject('dialog');
+ * dialog.addComponent(new NinePatch({
+ *   resource: 'dialogBg',
+ *   leftWidth: 30,
+ *   topHeight: 30,
+ *   rightWidth: 30,
+ *   bottomHeight: 30
+ * }));
+ * dialog.transform.size = { width: 400, height: 300 };
+ * ```
+ */
 class NinePatch$2 extends eva_js.Component {
     constructor() {
         super(...arguments);
+        /** 图片资源名称 */
         this.resource = '';
+        /** 精灵图集中的图片名称 */
         this.spriteName = '';
+        /** 左边不拉伸区域的宽度 */
         this.leftWidth = 0;
+        /** 顶部不拉伸区域的高度 */
         this.topHeight = 0;
+        /** 右边不拉伸区域的宽度 */
         this.rightWidth = 0;
+        /** 底部不拉伸区域的高度 */
         this.bottomHeight = 0;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 资源名称
+     * @param obj.spriteName - 精灵名称
+     * @param obj.leftWidth - 左边固定宽度
+     * @param obj.topHeight - 顶部固定高度
+     * @param obj.rightWidth - 右边固定宽度
+     * @param obj.bottomHeight - 底部固定高度
+     */
     init(obj) {
         this.resource = obj.resource;
         this.spriteName = obj.spriteName;
@@ -57,6 +126,7 @@ class NinePatch$2 extends eva_js.Component {
         this.bottomHeight = obj.bottomHeight;
     }
 }
+/** 组件名称 */
 NinePatch$2.componentName = 'NinePatch';
 __decorate([
     inspectorDecorator.type('string')
@@ -81,7 +151,7 @@ __decorate([
     inspectorDecorator.step(1)
 ], NinePatch$2.prototype, "bottomHeight", void 0);
 
-const resourceKeySplit = '_s|r|c_';
+const resourceKeySplit = '_s|r|c_'; // Notice: This key be created by sprite system.
 let NinePatch = class NinePatch extends pluginRenderer.Renderer {
     constructor() {
         super(...arguments);
@@ -144,6 +214,7 @@ let NinePatch = class NinePatch extends pluginRenderer.Renderer {
             component.ninePatch = np;
             this.containerManager
                 .getContainer(changed.gameObject.id)
+                // @ts-ignore
                 .addChildAt(np, 0);
         });
     }

package/dist/plugin-renderer-nine-patch.cjs.prod.js

@@ -1,16 +1 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),i=require("@eva/plugin-renderer"),r=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
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
-
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
-
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
-***************************************************************************** */
-function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var h=e.length-1;h>=0;h--)(n=e[h])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))((function(n,o){function s(e){try{c(r.next(e))}catch(e){o(e)}}function h(e){try{c(r.throw(e))}catch(e){o(e)}}function c(e){e.done?n(e.value):new i((function(t){t(e.value)})).then(s,h)}c((r=r.apply(e,t||[])).next())}))}class s extends e.Component{constructor(){super(...arguments),this.resource="",this.spriteName="",this.leftWidth=0,this.topHeight=0,this.rightWidth=0,this.bottomHeight=0}init(e){this.resource=e.resource,this.spriteName=e.spriteName,this.leftWidth=e.leftWidth,this.topHeight=e.topHeight,this.rightWidth=e.rightWidth,this.bottomHeight=e.bottomHeight}}s.componentName="NinePatch",n([t.type("string")],s.prototype,"resource",void 0),n([t.type("string")],s.prototype,"spriteName",void 0),n([t.type("number"),t.step(1)],s.prototype,"leftWidth",void 0),n([t.type("number"),t.step(1)],s.prototype,"topHeight",void 0),n([t.type("number"),t.step(1)],s.prototype,"rightWidth",void 0),n([t.type("number"),t.step(1)],s.prototype,"bottomHeight",void 0);let h=class extends i.Renderer{constructor(){super(...arguments),this.name="NinePatch",this.ninePatch={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size;this.ninePatch[e.id]&&(this.ninePatch[e.id].width=t,this.ninePatch[e.id].height=i)}componentChanged(t){return o(this,void 0,void 0,(function*(){"NinePatch"===t.componentName&&(t.type===e.OBSERVER_TYPE.ADD?this.add(t):t.type===e.OBSERVER_TYPE.REMOVE?this.remove(t):(this.remove(t),this.add(t)))}))}add(t){return o(this,void 0,void 0,(function*(){const i=t.component,n=t.gameObject.id,o=this.increaseAsyncId(n),{type:s,data:h,instance:c}=yield e.resource.getResource(i.resource);if(!this.validateAsyncId(n,o))return;if(!h)return void console.error(`GameObject:${t.gameObject.name}'s NinePatch resource load error`);let a;if(s===e.RESOURCE_TYPE.SPRITE&&i.spriteName){if(!c)return void console.error("GameObjectNinePatch Sprite resource rely on the Sprite system");a=c[i.resource+"_s|r|c_"+i.spriteName]}else a=h.image;const{leftWidth:d,topHeight:p,rightWidth:m,bottomHeight:u}=i,g=new r.NinePatch(a,d,p,m,u);this.ninePatch[t.gameObject.id]=g,i.ninePatch=g,this.containerManager.getContainer(t.gameObject.id).addChildAt(g,0)}))}remove(e){const t=e.gameObject.id;this.increaseAsyncId(t);const i=this.ninePatch[t];i&&(this.containerManager.getContainer(e.gameObject.id).removeChild(i),delete this.ninePatch[e.gameObject.id],i.destroy({children:!0}))}};h.systemName="NinePatch",h=n([e.decorators.componentObserver({NinePatch:["resource","spriteName","leftWidth","topHeight","rightWidth","bottomHeight"]})],h);var c=h;exports.NinePatch=s,exports.NinePatchSystem=c;
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});var e=require("@eva/eva.js"),t=require("@eva/inspector-decorator"),i=require("@eva/plugin-renderer"),r=require("@eva/renderer-adapter");function n(e,t,i,r){var n,o=arguments.length,s=o<3?t:null===r?r=Object.getOwnPropertyDescriptor(t,i):r;if("object"==typeof Reflect&&"function"==typeof Reflect.decorate)s=Reflect.decorate(e,t,i,r);else for(var h=e.length-1;h>=0;h--)(n=e[h])&&(s=(o<3?n(s):o>3?n(t,i,s):n(t,i))||s);return o>3&&s&&Object.defineProperty(t,i,s),s}function o(e,t,i,r){return new(i||(i=Promise))(function(n,o){function s(e){try{c(r.next(e))}catch(e){o(e)}}function h(e){try{c(r.throw(e))}catch(e){o(e)}}function c(e){var t;e.done?n(e.value):(t=e.value,t instanceof i?t:new i(function(e){e(t)})).then(s,h)}c((r=r.apply(e,t||[])).next())})}"function"==typeof SuppressedError&&SuppressedError;class s extends e.Component{constructor(){super(...arguments),this.resource="",this.spriteName="",this.leftWidth=0,this.topHeight=0,this.rightWidth=0,this.bottomHeight=0}init(e){this.resource=e.resource,this.spriteName=e.spriteName,this.leftWidth=e.leftWidth,this.topHeight=e.topHeight,this.rightWidth=e.rightWidth,this.bottomHeight=e.bottomHeight}}s.componentName="NinePatch",n([t.type("string")],s.prototype,"resource",void 0),n([t.type("string")],s.prototype,"spriteName",void 0),n([t.type("number"),t.step(1)],s.prototype,"leftWidth",void 0),n([t.type("number"),t.step(1)],s.prototype,"topHeight",void 0),n([t.type("number"),t.step(1)],s.prototype,"rightWidth",void 0),n([t.type("number"),t.step(1)],s.prototype,"bottomHeight",void 0);let h=class extends i.Renderer{constructor(){super(...arguments),this.name="NinePatch",this.ninePatch={}}init(){this.renderSystem=this.game.getSystem(i.RendererSystem),this.renderSystem.rendererManager.register(this)}rendererUpdate(e){const{width:t,height:i}=e.transform.size;this.ninePatch[e.id]&&(this.ninePatch[e.id].width=t,this.ninePatch[e.id].height=i)}componentChanged(t){return o(this,void 0,void 0,function*(){"NinePatch"===t.componentName&&(t.type===e.OBSERVER_TYPE.ADD?this.add(t):t.type===e.OBSERVER_TYPE.REMOVE?this.remove(t):(this.remove(t),this.add(t)))})}add(t){return o(this,void 0,void 0,function*(){const i=t.component,n=t.gameObject.id,o=this.increaseAsyncId(n),{type:s,data:h,instance:c}=yield e.resource.getResource(i.resource);if(!this.validateAsyncId(n,o))return;if(!h)return void console.error(`GameObject:${t.gameObject.name}'s NinePatch resource load error`);let a;if(s===e.RESOURCE_TYPE.SPRITE&&i.spriteName){if(!c)return void console.error("GameObjectNinePatch Sprite resource rely on the Sprite system");a=c[i.resource+"_s|r|c_"+i.spriteName]}else a=h.image;const{leftWidth:d,topHeight:p,rightWidth:m,bottomHeight:u}=i,g=new r.NinePatch(a,d,p,m,u);this.ninePatch[t.gameObject.id]=g,i.ninePatch=g,this.containerManager.getContainer(t.gameObject.id).addChildAt(g,0)})}remove(e){const t=e.gameObject.id;this.increaseAsyncId(t);const i=this.ninePatch[t];i&&(this.containerManager.getContainer(e.gameObject.id).removeChild(i),delete this.ninePatch[e.gameObject.id],i.destroy({children:!0}))}};h.systemName="NinePatch",h=n([e.decorators.componentObserver({NinePatch:["resource","spriteName","leftWidth","topHeight","rightWidth","bottomHeight"]})],h);var c=h;exports.NinePatch=s,exports.NinePatchSystem=c;

package/dist/plugin-renderer-nine-patch.d.ts

@@ -7,15 +7,80 @@ import { Renderer } from '@eva/plugin-renderer';
 import { RendererManager } from '@eva/plugin-renderer';
 import { RendererSystem } from '@eva/plugin-renderer';
 
+/**
+ * 九宫格组件
+ *
+ * NinePatch 组件用于实现可拉伸的图片，保持边角不变形。
+ * 将图片分为 9 个区域，拉伸时只拉伸中间区域，边角保持原始比例，
+ * 适用于按钮、对话框、面板等需要自适应尺寸的 UI 元素。
+ *
+ * 九宫格原理：
+ * ```
+ * +-------+-------+-------+
+ * | 左上  |  上   | 右上  |
+ * +-------+-------+-------+
+ * |  左   | 中间  |  右   |
+ * +-------+-------+-------+
+ * | 左下  |  下   | 右下  |
+ * +-------+-------+-------+
+ * ```
+ * 拉伸时，四个角保持不变，四条边单向拉伸，中间区域双向拉伸。
+ *
+ * @example
+ * ```typescript
+ * // 创建可拉伸的按钮背景
+ * const button = new GameObject('button');
+ * button.addComponent(new NinePatch({
+ *   resource: 'buttonBg', // 按钮背景资源
+ *   spriteName: 'btn_normal.png',
+ *   leftWidth: 20,   // 左边不拉伸区域宽度
+ *   topHeight: 20,   // 顶部不拉伸区域高度
+ *   rightWidth: 20,  // 右边不拉伸区域宽度
+ *   bottomHeight: 20 // 底部不拉伸区域高度
+ * }));
+ *
+ * // 设置按钮尺寸（自动拉伸）
+ * button.transform.size = { width: 200, height: 60 };
+ *
+ * // 创建对话框背景
+ * const dialog = new GameObject('dialog');
+ * dialog.addComponent(new NinePatch({
+ *   resource: 'dialogBg',
+ *   leftWidth: 30,
+ *   topHeight: 30,
+ *   rightWidth: 30,
+ *   bottomHeight: 30
+ * }));
+ * dialog.transform.size = { width: 400, height: 300 };
+ * ```
+ */
 export declare class NinePatch extends Component<NinePatchParams> {
+    /** 组件名称 */
     static componentName: string;
+    /** 九宫格精灵实例 */
     ninePatch: NinePatch_2;
+    /** 图片资源名称 */
     resource: string;
+    /** 精灵图集中的图片名称 */
     spriteName: string;
+    /** 左边不拉伸区域的宽度 */
     leftWidth: number;
+    /** 顶部不拉伸区域的高度 */
     topHeight: number;
+    /** 右边不拉伸区域的宽度 */
     rightWidth: number;
+    /** 底部不拉伸区域的高度 */
     bottomHeight: number;
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 资源名称
+     * @param obj.spriteName - 精灵名称
+     * @param obj.leftWidth - 左边固定宽度
+     * @param obj.topHeight - 顶部固定高度
+     * @param obj.rightWidth - 右边固定宽度
+     * @param obj.bottomHeight - 底部固定高度
+     */
     init(obj?: NinePatchParams): void;
 }
 

package/dist/plugin-renderer-nine-patch.esm.js

@@ -3,19 +3,19 @@ import { type, step } from '@eva/inspector-decorator';
 import { Renderer, RendererSystem } from '@eva/plugin-renderer';
 import { NinePatch as NinePatch$3 } from '@eva/renderer-adapter';
 
-/*! *****************************************************************************
-Copyright (c) Microsoft Corporation. All rights reserved.
-Licensed under the Apache License, Version 2.0 (the "License"); you may not use
-this file except in compliance with the License. You may obtain a copy of the
-License at http://www.apache.org/licenses/LICENSE-2.0
+/******************************************************************************
+Copyright (c) Microsoft Corporation.
 
-THIS CODE IS PROVIDED ON AN *AS IS* BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
-KIND, EITHER EXPRESS OR IMPLIED, INCLUDING WITHOUT LIMITATION ANY IMPLIED
-WARRANTIES OR CONDITIONS OF TITLE, FITNESS FOR A PARTICULAR PURPOSE,
-MERCHANTABLITY OR NON-INFRINGEMENT.
+Permission to use, copy, modify, and/or distribute this software for any
+purpose with or without fee is hereby granted.
 
-See the Apache Version 2.0 License for specific language governing permissions
-and limitations under the License.
+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) {
@@ -26,24 +26,93 @@ function __decorate(decorators, target, key, desc) {
 }
 
 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) : new P(function (resolve) { resolve(result.value); }).then(fulfilled, rejected); }
+        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;
+};
 
+/**
+ * 九宫格组件
+ *
+ * NinePatch 组件用于实现可拉伸的图片，保持边角不变形。
+ * 将图片分为 9 个区域，拉伸时只拉伸中间区域，边角保持原始比例，
+ * 适用于按钮、对话框、面板等需要自适应尺寸的 UI 元素。
+ *
+ * 九宫格原理：
+ * ```
+ * +-------+-------+-------+
+ * | 左上  |  上   | 右上  |
+ * +-------+-------+-------+
+ * |  左   | 中间  |  右   |
+ * +-------+-------+-------+
+ * | 左下  |  下   | 右下  |
+ * +-------+-------+-------+
+ * ```
+ * 拉伸时，四个角保持不变，四条边单向拉伸，中间区域双向拉伸。
+ *
+ * @example
+ * ```typescript
+ * // 创建可拉伸的按钮背景
+ * const button = new GameObject('button');
+ * button.addComponent(new NinePatch({
+ *   resource: 'buttonBg', // 按钮背景资源
+ *   spriteName: 'btn_normal.png',
+ *   leftWidth: 20,   // 左边不拉伸区域宽度
+ *   topHeight: 20,   // 顶部不拉伸区域高度
+ *   rightWidth: 20,  // 右边不拉伸区域宽度
+ *   bottomHeight: 20 // 底部不拉伸区域高度
+ * }));
+ *
+ * // 设置按钮尺寸（自动拉伸）
+ * button.transform.size = { width: 200, height: 60 };
+ *
+ * // 创建对话框背景
+ * const dialog = new GameObject('dialog');
+ * dialog.addComponent(new NinePatch({
+ *   resource: 'dialogBg',
+ *   leftWidth: 30,
+ *   topHeight: 30,
+ *   rightWidth: 30,
+ *   bottomHeight: 30
+ * }));
+ * dialog.transform.size = { width: 400, height: 300 };
+ * ```
+ */
 class NinePatch$2 extends Component {
     constructor() {
         super(...arguments);
+        /** 图片资源名称 */
         this.resource = '';
+        /** 精灵图集中的图片名称 */
         this.spriteName = '';
+        /** 左边不拉伸区域的宽度 */
         this.leftWidth = 0;
+        /** 顶部不拉伸区域的高度 */
         this.topHeight = 0;
+        /** 右边不拉伸区域的宽度 */
         this.rightWidth = 0;
+        /** 底部不拉伸区域的高度 */
         this.bottomHeight = 0;
     }
+    /**
+     * 初始化组件
+     * @param obj - 初始化参数
+     * @param obj.resource - 资源名称
+     * @param obj.spriteName - 精灵名称
+     * @param obj.leftWidth - 左边固定宽度
+     * @param obj.topHeight - 顶部固定高度
+     * @param obj.rightWidth - 右边固定宽度
+     * @param obj.bottomHeight - 底部固定高度
+     */
     init(obj) {
         this.resource = obj.resource;
         this.spriteName = obj.spriteName;
@@ -53,6 +122,7 @@ class NinePatch$2 extends Component {
         this.bottomHeight = obj.bottomHeight;
     }
 }
+/** 组件名称 */
 NinePatch$2.componentName = 'NinePatch';
 __decorate([
     type('string')
@@ -77,7 +147,7 @@ __decorate([
     step(1)
 ], NinePatch$2.prototype, "bottomHeight", void 0);
 
-const resourceKeySplit = '_s|r|c_';
+const resourceKeySplit = '_s|r|c_'; // Notice: This key be created by sprite system.
 let NinePatch = class NinePatch extends Renderer {
     constructor() {
         super(...arguments);
@@ -140,6 +210,7 @@ let NinePatch = class NinePatch extends Renderer {
             component.ninePatch = np;
             this.containerManager
                 .getContainer(changed.gameObject.id)
+                // @ts-ignore
                 .addChildAt(np, 0);
         });
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@eva/plugin-renderer-nine-patch",
-  "version": "2.0.1-beta.9",
+  "version": "2.0.2-beta.0",
   "description": "@eva/plugin-renderer-nine-patch",
   "main": "index.js",
   "module": "dist/plugin-renderer-nine-patch.esm.js",
@@ -19,8 +19,8 @@
   "homepage": "https://eva.js.org",
   "dependencies": {
     "@eva/inspector-decorator": "^0.0.5",
-    "@eva/plugin-renderer": "2.0.1-beta.9",
-    "@eva/renderer-adapter": "2.0.1-beta.9",
-    "@eva/eva.js": "2.0.1-beta.9"
+    "@eva/plugin-renderer": "2.0.2-beta.0",
+    "@eva/renderer-adapter": "2.0.2-beta.0",
+    "@eva/eva.js": "2.0.2-beta.0"
   }
 }