@galacean/engine-spine 4.2.0-beta.2 → 4.2.0-beta.3

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "4.2.0-beta.2",
+  "version": "4.2.0-beta.3",
   "description": "galacean spine runtime",
   "name": "@galacean/engine-spine",
   "main": "dist/main.js",
@@ -20,7 +20,7 @@
     "@babel/plugin-transform-object-assign": "^7.12.1",
     "@babel/preset-env": "^7.24.8",
     "@babel/preset-typescript": "^7.24.7",
-    "@galacean/engine": "^1.3.20",
+    "@galacean/engine": "^1.3.0-alpha.3",
     "@galacean/engine-toolkit": "beta",
     "@rollup/plugin-babel": "^5.2.1",
     "@rollup/plugin-commonjs": "^16.0.0",
@@ -107,11 +107,12 @@
     "e2e": "cypress run --browser chrome --headless",
     "e2e:debug": "cypress open",
     "dev": "rollup -cw",
-    "build": "npm run b:types && cross-env BUILD_TYPE=ALL rollup -c",
+    "build": "cross-env BUILD_TYPE=ALL rollup -c",
     "build:watch": "npm run b:types && cross-env BUILD_TYPE=ALL rollup -c --watch",
     "ci": "npm run lint && npm run test-cov",
     "lint": "eslint src --fix --ext .ts,.tsx",
-    "b:types": "tsc --emitDeclarationOnly"
+    "b:types": "tsc --emitDeclarationOnly",
+    "b:all": "npm run b:types && npm run build"
   },
   "types": "types/index.d.ts",
   "repository": "https://github.com/johanzhu/engine-spine.git"

package/types/example/outline.d.ts

@@ -0,0 +1,11 @@
+import { Entity, MeshRenderer, Camera } from '@galacean/engine';
+export default class BoundingBoxLine extends MeshRenderer {
+    private attachedEntity;
+    private renderers;
+    private boundingBox;
+    constructor(entity: Entity);
+    updateBoundingBox(): void;
+    attachToEntity(entity: Entity): void;
+    private updateVertices;
+    _render(camera: Camera): void;
+}

package/types/loader/AdaptiveTexture.d.ts

@@ -0,0 +1,13 @@
+import { Texture, TextureFilter, TextureWrap } from "@esotericsoftware/spine-core";
+import { Texture2D } from "@galacean/engine";
+/**
+ * @internal
+ */
+export declare class AdaptiveTexture extends Texture {
+    constructor(image: Texture2D);
+    getImage(): Texture2D;
+    setFilters(minFilter: TextureFilter, magFilter: TextureFilter): void;
+    setWraps(uWrap: TextureWrap, vWrap: TextureWrap): void;
+    dispose(): void;
+    private _convertWrapMode;
+}

package/types/loader/SpineAtlasLoader.d.ts

@@ -0,0 +1,7 @@
+import { TextureAtlas } from "@esotericsoftware/spine-core";
+import { AssetPromise, Loader, LoadItem, ResourceManager } from "@galacean/engine";
+export declare class SpineAtlasLoader extends Loader<TextureAtlas> {
+    private static _groupAssetsByExtension;
+    private static _assignSpineAtlas;
+    load(item: LoadItem, resourceManager: ResourceManager): AssetPromise<TextureAtlas>;
+}

package/types/loader/SpineResource.d.ts

@@ -3,15 +3,15 @@ import { Engine, Entity, ReferResource } from "@galacean/engine";
 /**
  * Represents a resource that manages Spine animation data, textures, and entity templates for the Galacean engine.
  *
-*/
+ */
 export declare class SpineResource extends ReferResource {
-    /** Name of skeletonData. */
-    readonly name: string;
+    /** The url of spine resource. */
+    readonly url: string;
     private _texturesInSpineAtlas;
     private _skeletonData;
     private _stateData;
     private _template;
-    constructor(engine: Engine, skeletonData: SkeletonData, name?: string);
+    constructor(engine: Engine, skeletonData: SkeletonData, url?: string);
     /**
      * The skeleton data associated with this Spine resource.
      */
@@ -29,4 +29,5 @@ export declare class SpineResource extends ReferResource {
     private _createTemplate;
     private _associationTextureInSkeletonData;
     private _disassociationSuperResource;
+    private _extractFileName;
 }

package/types/loader/SpineTexture.d.ts

@@ -0,0 +1,13 @@
+import { Texture, TextureFilter, TextureWrap } from "@esotericsoftware/spine-core";
+import { Texture2D } from "@galacean/engine";
+/**
+ * @internal
+ */
+export declare class SpineTexture extends Texture {
+    constructor(image: Texture2D);
+    getImage(): Texture2D;
+    setFilters(minFilter: TextureFilter, magFilter: TextureFilter): void;
+    setWraps(uWrap: TextureWrap, vWrap: TextureWrap): void;
+    dispose(): void;
+    private _convertWrapMode;
+}

package/types/loader/index.d.ts

@@ -0,0 +1,4 @@
+import "./SpineLoader";
+import "./SpineAtlasLoader";
+export { SpineResource } from "./SpineResource";
+export { LoaderUtils } from "./LoaderUtils";

package/types/renderer/SpineAnimationRenderer.d.ts

@@ -0,0 +1,177 @@
+import { AnimationState, Skeleton } from "@esotericsoftware/spine-core";
+import { BoundingBox, Buffer, Engine, Entity, Material, Primitive, Renderer, SubPrimitive } from "@galacean/engine";
+import { SpineResource } from "../loader/SpineResource";
+/**
+ * Spine animation renderer, capable of rendering spine animations and providing functions for animation and skeleton manipulation.
+ */
+export declare class SpineAnimationRenderer extends Renderer {
+    private static _defaultMaterial;
+    private static _spineGenerator;
+    private static _positionVertexElement;
+    private static _colorVertexElement;
+    private static _uvVertexElement;
+    /** @internal */
+    static _materialCache: Map<string, Material>;
+    /** @internal */
+    static _getDefaultMaterial(engine: Engine): Material;
+    /**
+     * The spacing between z layers.
+     */
+    zSpacing: number;
+    /**
+     * Whether to use premultiplied alpha mode for rendering.
+     * When enabled, vertex color values are multiplied by the alpha channel.
+     * @remarks
+   If this option is enabled, the Spine editor must export textures with "Premultiply Alpha" checked.
+     */
+    premultipliedAlpha: boolean;
+    /**
+     * Default state for spine animation.
+     * Contains the default animation name to be played, whether this animation should loop, the default skin name.
+     */
+    readonly defaultConfig: SpineAnimationDefaultConfig;
+    /** @internal */
+    _primitive: Primitive;
+    /** @internal */
+    _subPrimitives: SubPrimitive[];
+    /** @internal */
+    _indexBuffer: Buffer;
+    /** @internal */
+    _vertexBuffer: Buffer;
+    /** @internal */
+    _vertices: Float32Array<ArrayBuffer>;
+    /** @internal */
+    _indices: Uint16Array<ArrayBuffer>;
+    /** @internal */
+    _needResizeBuffer: boolean;
+    /** @internal */
+    _vertexCount: number;
+    /** @internal */
+    _resource: SpineResource;
+    /** @internal */
+    _localBounds: BoundingBox;
+    private _skeleton;
+    private _state;
+    /**
+     * The Spine.AnimationState object of this SpineAnimationRenderer.
+     * Manage, blend, and transition between multiple simultaneous animations effectively.
+     */
+    get state(): AnimationState;
+    /**
+     * The Spine.Skeleton object of this SpineAnimationRenderer.
+     * Manipulate bone positions, rotations, scaling
+     * and change spine attachment to customize character appearances dynamically during runtime.
+     */
+    get skeleton(): Skeleton;
+    /**
+     * @internal
+     */
+    constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    _onEnable(): void;
+    /**
+     * @internal
+     */
+    update(delta: number): void;
+    /**
+     * @internal
+     */
+    _render(context: any): void;
+    /**
+     * @internal
+     */
+    _updateBounds(worldBounds: BoundingBox): void;
+    /**
+     * @internal
+     */
+    _setSkeleton(skeleton: Skeleton): void;
+    /**
+     * @internal
+     */
+    _setState(state: AnimationState): void;
+    /**
+     * @internal
+     */
+    _cloneTo(target: SpineAnimationRenderer): void;
+    /**
+     * @internal
+     */
+    _onDestroy(): void;
+    /**
+     * @internal
+     */
+    _createAndBindBuffer(vertexCount: number): void;
+    /**
+     * @internal
+     */
+    _addSubPrimitive(subPrimitive: SubPrimitive): void;
+    /**
+     * @internal
+     */
+    _clearSubPrimitives(): void;
+    private _clearMaterialCache;
+    private _applyDefaultConfig;
+    /**
+     * * @deprecated This property is deprecated and will be removed in future releases.
+     * Spine resource of current spine animation.
+     */
+    get resource(): SpineResource;
+    /**
+     * * @deprecated This property is deprecated and will be removed in future releases.
+     * Sets the Spine resource for the current animation. This property allows switching to a different `SpineResource`.
+     *
+     * @param value - The new `SpineResource` to be used for the current animation
+     */
+    set resource(value: SpineResource);
+}
+/**
+ * @internal
+ */
+export declare enum SpineAnimationUpdateFlags {
+    /** On Animation change */
+    Animation = 2
+}
+/**
+ * @internal
+ */
+export declare enum RendererUpdateFlags {
+    /** Include world position and world bounds. */
+    WorldVolume = 1
+}
+/**
+ * Default state for spine animation.
+ * Contains the default animation name to be played, whether this animation should loop,
+ * the default skin name, and the default scale of the skeleton.
+ */
+export declare class SpineAnimationDefaultConfig {
+    /**
+     * Whether the default animation should loop @defaultValue `true. The default animation should loop`
+     */
+    loop: boolean;
+    /**
+     * The name of the default animation @defaultValue `null. Do not play any animation by default`
+     */
+    animationName: string | null;
+    /**
+     * The name of the default skin @defaultValue `default`
+     */
+    skinName: string;
+    /**
+     * Creates an instance of default config
+     */
+    constructor(
+    /**
+     * Whether the default animation should loop @defaultValue `true. The default animation should loop`
+     */
+    loop?: boolean, 
+    /**
+     * The name of the default animation @defaultValue `null. Do not play any animation by default`
+     */
+    animationName?: string | null, 
+    /**
+     * The name of the default skin @defaultValue `default`
+     */
+    skinName?: string);
+}

package/types/renderer/SpineGenerator.d.ts

@@ -0,0 +1,35 @@
+import { BlendMode, Color, Skeleton } from "@esotericsoftware/spine-core";
+import { SubPrimitive, Texture2D } from "@galacean/engine";
+import { SpineAnimationRenderer } from "./SpineAnimationRenderer";
+import { ClearablePool } from "../util/ClearablePool";
+import { ReturnablePool } from "../util/ReturnablePool";
+declare class SubRenderItem {
+    subPrimitive: SubPrimitive;
+    blendMode: BlendMode;
+    texture: any;
+    slotName?: string;
+}
+/**
+ * @internal
+ */
+export declare class SpineGenerator {
+    static VERTEX_SIZE: number;
+    static VERTEX_STRIDE: number;
+    static tempDark: Color;
+    static tempColor: Color;
+    static tempVerts: any[];
+    static QUAD_TRIANGLES: number[];
+    static subPrimitivePool: ReturnablePool<SubPrimitive>;
+    static subRenderItemPool: ClearablePool<SubRenderItem>;
+    private _separateSlots;
+    private _subRenderItems;
+    private _clipper;
+    private _separateSlotTextureMap;
+    buildPrimitive(skeleton: Skeleton, renderer: SpineAnimationRenderer): void;
+    addSeparateSlot(slotName: string): void;
+    addSeparateSlotTexture(slotName: string, texture: Texture2D): void;
+    private _createMaterialForTexture;
+    private _createRenderItem;
+    private _expandBounds;
+}
+export {};

package/types/renderer/SpineMaterial.d.ts

@@ -0,0 +1,6 @@
+import { Engine, Material } from "@galacean/engine";
+export declare class SpineMaterial extends Material {
+    private static _spineVS;
+    private static _spineFS;
+    constructor(engine: Engine);
+}

package/types/renderer/index.d.ts

@@ -0,0 +1,2 @@
+export { SpineAnimationRenderer } from "./SpineAnimationRenderer";
+export { SpineMaterial } from "./SpineMaterial";

package/types/src/SpineAnimationRenderer.d.ts

@@ -0,0 +1,197 @@
+import { AnimationState, Skeleton } from "@esotericsoftware/spine-core";
+import { BoundingBox, Buffer, Engine, Entity, Material, Primitive, Renderer, SubPrimitive } from "@galacean/engine";
+import { SpineResource } from "./loader/SpineResource";
+/**
+ * Spine animation renderer, capable of rendering spine animations and providing functions for animation and skeleton manipulation.
+ */
+export declare class SpineAnimationRenderer extends Renderer {
+    private static _defaultMaterial;
+    private static _spineGenerator;
+    private static _positionVertexElement;
+    private static _colorVertexElement;
+    private static _uvVertexElement;
+    /** @internal */
+    static _materialCache: Map<string, Material>;
+    /** @internal */
+    static _getDefaultMaterial(engine: Engine): Material;
+    /**
+     * The spacing between z layers.
+     */
+    zSpacing: number;
+    /**
+     * Whether to use premultiplied alpha mode for rendering.
+     * When enabled, vertex color values are multiplied by the alpha channel.
+     * @remarks
+   If this option is enabled, the Spine editor must export textures with "Premultiply Alpha" checked.
+     */
+    premultipliedAlpha: boolean;
+    /**
+     * Updates the bounding box every frame when enabled.
+     * Otherwise, it is calculated only during animation initialization.
+     */
+    updateBoundsPerFrame: boolean;
+    /**
+     * Default state for spine animation.
+     * Contains the default animation name to be played, whether this animation should loop, the default skin name.
+     */
+    readonly defaultConfig: SpineAnimationDefaultConfig;
+    /** @internal */
+    _primitive: Primitive;
+    /** @internal */
+    _subPrimitives: SubPrimitive[];
+    /** @internal */
+    _indexBuffer: Buffer;
+    /** @internal */
+    _vertexBuffer: Buffer;
+    /** @internal */
+    _vertices: Float32Array<ArrayBuffer>;
+    /** @internal */
+    _indices: Uint16Array<ArrayBuffer>;
+    /** @internal */
+    _needResizeBuffer: boolean;
+    /** @internal */
+    _vertexCount: number;
+    /** @internal */
+    _resource: SpineResource;
+    /** @internal */
+    _spineBounds: BoundingBox;
+    /** @internal */
+    _needsInitialize: boolean;
+    private _skeleton;
+    private _state;
+    /**
+     * The Spine.AnimationState object of this SpineAnimationRenderer.
+     * Manage, blend, and transition between multiple simultaneous animations effectively.
+     */
+    get state(): AnimationState;
+    /**
+     * The Spine.Skeleton object of this SpineAnimationRenderer.
+     * Manipulate bone positions, rotations, scaling
+     * and change spine attachment to customize character appearances dynamically during runtime.
+     */
+    get skeleton(): Skeleton;
+    /**
+     * @internal
+     */
+    constructor(entity: Entity);
+    /**
+     * @internal
+     */
+    _onEnable(): void;
+    /**
+     * @internal
+     */
+    update(delta: number): void;
+    /**
+     * @internal
+     */
+    _render(context: any): void;
+    /**
+     * @internal
+     */
+    _updateBounds(worldBounds: BoundingBox): void;
+    /**
+     * @internal
+     */
+    _setSkeleton(skeleton: Skeleton): void;
+    /**
+     * @internal
+     */
+    _setState(state: AnimationState): void;
+    /**
+     * @internal
+     */
+    _cloneTo(target: SpineAnimationRenderer): void;
+    /**
+     * @internal
+     */
+    _onDestroy(): void;
+    /**
+     * @internal
+     */
+    _createAndBindBuffer(vertexCount: number): void;
+    /**
+     * @internal
+     */
+    _addSubPrimitive(subPrimitive: SubPrimitive): void;
+    /**
+     * @internal
+     */
+    _clearSubPrimitives(): void;
+    /**
+     * @internal
+     */
+    _isContainDirtyFlag(type: number): boolean;
+    /**
+     * @internal
+     */
+    _setDirtyFlagFalse(type: number): void;
+    private _initialize;
+    private _onAnimationStart;
+    private _onAnimationEnd;
+    private _clearMaterialCache;
+    private _applyDefaultConfig;
+    /**
+     * * @deprecated This property is deprecated and will be removed in future releases.
+     * Spine resource of current spine animation.
+    */
+    get resource(): SpineResource;
+    /**
+     * * @deprecated This property is deprecated and will be removed in future releases.
+     * Sets the Spine resource for the current animation. This property allows switching to a different `SpineResource`.
+     *
+     * @param value - The new `SpineResource` to be used for the current animation
+    */
+    set resource(value: SpineResource);
+}
+/**
+ * @internal
+ */
+export declare enum SpineAnimationUpdateFlags {
+    /** On Animation start play */
+    AnimationVolume = 2,
+    /** On skeleton data asset changed */
+    InitialVolume = 4
+}
+/**
+ * @internal
+ */
+export declare enum RendererUpdateFlags {
+    /** Include world position and world bounds. */
+    WorldVolume = 1
+}
+/**
+ * Default state for spine animation.
+ * Contains the default animation name to be played, whether this animation should loop,
+ * the default skin name, and the default scale of the skeleton.
+ */
+export declare class SpineAnimationDefaultConfig {
+    /**
+     * Whether the default animation should loop @defaultValue `true. The default animation should loop`
+     */
+    loop: boolean;
+    /**
+     * The name of the default animation @defaultValue `null. Do not play any animation by default`
+     */
+    animationName: string | null;
+    /**
+     * The name of the default skin @defaultValue `default`
+     */
+    skinName: string;
+    /**
+     * Creates an instance of default config
+     */
+    constructor(
+    /**
+     * Whether the default animation should loop @defaultValue `true. The default animation should loop`
+     */
+    loop?: boolean, 
+    /**
+     * The name of the default animation @defaultValue `null. Do not play any animation by default`
+     */
+    animationName?: string | null, 
+    /**
+     * The name of the default skin @defaultValue `default`
+     */
+    skinName?: string);
+}

package/types/src/SpineGenerator.d.ts

@@ -0,0 +1,34 @@
+import { BlendMode, Color, Skeleton } from "@esotericsoftware/spine-core";
+import { SubPrimitive, Texture2D } from "@galacean/engine";
+import { SpineAnimationRenderer } from "./SpineAnimationRenderer";
+import { AdaptiveTexture } from "./loader/LoaderUtils";
+import { ClearablePool } from "./util/ClearablePool";
+import { ReturnablePool } from "./util/ReturnablePool";
+declare class SubRenderItem {
+    subPrimitive: SubPrimitive;
+    blendMode: BlendMode;
+    texture: any;
+    slotName?: string;
+}
+export declare class SpineGenerator {
+    static QUAD_TRIANGLES: number[];
+    static VERTEX_SIZE: number;
+    static VERTEX_STRIDE: number;
+    static tempDark: Color;
+    static tempColor: Color;
+    static tempVerts: any[];
+    static tempBlendMode: BlendMode | null;
+    static tempTexture: AdaptiveTexture | null;
+    static subPrimitivePool: ReturnablePool<SubPrimitive>;
+    static subRenderItemPool: ClearablePool<SubRenderItem>;
+    private _clipper;
+    private _subRenderItems;
+    private _separateSlots;
+    private _separateSlotTextureMap;
+    buildPrimitive(skeleton: Skeleton, renderer: SpineAnimationRenderer, shouldUpdateBounds: boolean): void;
+    addSeparateSlot(slotName: string): void;
+    addSeparateSlotTexture(slotName: string, texture: Texture2D): void;
+    private _createMaterialForTexture;
+    private _expandByPoint;
+}
+export {};

package/types/src/index.d.ts

@@ -0,0 +1,9 @@
+import "./loader/SpineLoader";
+import "./loader/EditorSpineAtlasLoader";
+import BoundingBoxLine from "../example/outline";
+export { SpineAnimationRenderer } from "./SpineAnimationRenderer";
+export { SpineResource } from "./loader/SpineResource";
+export { createTextureAtlas } from "./loader/LoaderUtils";
+export { BoundingBoxLine };
+export * from "@esotericsoftware/spine-core";
+export declare const version = "__buildVersion";

package/types/src/loader/SpineLoader.d.ts

@@ -0,0 +1,29 @@
+import { AssetPromise, Loader, LoadItem, ResourceManager } from "@galacean/engine";
+import { SpineResource } from "./SpineResource";
+export type SpineAssetBundle = {
+    skeletonPath: string;
+    skeletonExtension: string;
+    skeletonTextData?: string | ArrayBuffer;
+    atlasPath: string;
+    imagePaths: string[];
+    imageExtensions: string[];
+};
+type SpineLoaderParams = {
+    fileExtensions?: string | string[];
+};
+type SpineLoadItem = LoadItem & {
+    params?: SpineLoaderParams;
+};
+export declare class SpineLoader extends Loader<SpineResource> {
+    static imageExtensions: string[];
+    static skeletonExtensions: string[];
+    static parseAndAssignSpineAsset(url: string, fileExtension: string | null, bundle: SpineAssetBundle): void;
+    static deriveAndAssignSpineAsset(url: string, fileExtension: string | null, bundle: SpineAssetBundle): void;
+    static verifyFileExtensions(fileExtensions: string | string[], expectArray: boolean): string | string[] | null;
+    static getUrlExtension(url: string, fileExtension: string): string | null;
+    load(item: SpineLoadItem, resourceManager: ResourceManager): AssetPromise<SpineResource>;
+    private _handleEditorAsset;
+    private _handleOriginAsset;
+    private _determineSkeletonDataType;
+}
+export {};

package/types/src/loader/SpineResource.d.ts

@@ -0,0 +1,33 @@
+import { AnimationStateData, SkeletonData } from "@esotericsoftware/spine-core";
+import { Engine, Entity, ReferResource } from "@galacean/engine";
+/**
+ * Represents a resource that manages Spine animation data, textures, and entity templates for the Galacean engine.
+ *
+*/
+export declare class SpineResource extends ReferResource {
+    /** The url of skeletonData. */
+    readonly url: string;
+    private _texturesInSpineAtlas;
+    private _skeletonData;
+    private _stateData;
+    private _template;
+    constructor(engine: Engine, skeletonData: SkeletonData, url?: string);
+    /**
+     * The skeleton data associated with this Spine resource.
+     */
+    get skeletonData(): SkeletonData;
+    /**
+     * The animation state data associated with this Spine resource.
+     */
+    get stateData(): AnimationStateData;
+    /**
+     * Creates and returns a new instance of the spine entity template.
+     * @returns A instance of the spine entity template
+     */
+    instantiate(): Entity;
+    protected _onDestroy(): void;
+    private _createTemplate;
+    private _associationTextureInSkeletonData;
+    private _disassociationSuperResource;
+    private _extractFileName;
+}

package/types/util/AttachmentTools.d.ts

@@ -1,3 +1,24 @@
-import { MeshAttachment, RegionAttachment, TextureAtlasRegion } from "@esotericsoftware/spine-core";
-export declare function createAttachmentFromRegion(region: TextureAtlasRegion, attachmentName: string, scale?: number, rotation?: number): RegionAttachment;
-export declare function cloneAttachmentWithRegion(attachment: RegionAttachment | MeshAttachment, atlasRegion: TextureAtlasRegion, cloneMeshAsLinked?: boolean, useOriginalRegionSize?: boolean, scale?: number): import("@esotericsoftware/spine-core").Attachment;
+import { Attachment, MeshAttachment, RegionAttachment, TextureAtlasRegion } from "@esotericsoftware/spine-core";
+export declare class AttachmentTools {
+    /**
+     * Creates a new `RegionAttachment` from a specified texture atlas region.
+     *
+     * @param region - The texture atlas region used to create the attachment.
+     * @param attachmentName - The name of the new attachment.
+     * @param scale - A scaling factor applied to the attachment's dimensions (default is 1).
+     * @param rotation - The rotation angle of the attachment in degrees (default is 0).
+     * @returns The created `RegionAttachment` with the passed in region.
+     */
+    static createAttachmentFromRegion(region: TextureAtlasRegion, attachmentName: string, scale?: number, rotation?: number): RegionAttachment;
+    /**
+     * Clones an attachment (`RegionAttachment` or `MeshAttachment`) and applies a new texture atlas region.
+     *
+     * @param attachment - The attachment to clone (either `RegionAttachment` or `MeshAttachment`).
+     * @param atlasRegion - The new texture atlas region to associate with the cloned attachment.
+     * @param useOriginalRegionSize - Whether to retain the original region's size for the cloned attachment (default is `false`).
+     * @param scale - A scaling factor applied to the dimensions of the cloned attachment (default is 1).
+     * @param cloneMeshAsLinked - If `true`, clones a `MeshAttachment` as a linked mesh (default is `true`).
+     * @returns The cloned attachment with the specified properties and the new texture region.
+     */
+    static cloneAttachmentWithRegion(attachment: RegionAttachment | MeshAttachment, atlasRegion: TextureAtlasRegion, useOriginalRegionSize?: boolean, scale?: number, cloneMeshAsLinked?: boolean): Attachment;
+}

package/types/util/index.d.ts

@@ -0,0 +1 @@
+export { AttachmentTools } from "./AttachmentTools";