@galacean/engine-spine 0.0.0-experimental-engine-spine-4.2.1 → 0.0.0-experimental-engine-spine-2025509

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (62) hide show
  1. package/README.md +43 -67
  2. package/dist/browser.js +1 -1
  3. package/dist/main.js +1 -11747
  4. package/dist/main.js.map +1 -1
  5. package/dist/module.js +1 -11634
  6. package/dist/module.js.map +1 -1
  7. package/package.json +27 -94
  8. package/types/SpineAnimation.d.ts +48 -0
  9. package/types/SpineLoader.d.ts +32 -0
  10. package/types/SpineMaterial.d.ts +6 -0
  11. package/types/SpineRenderer.d.ts +38 -0
  12. package/types/core/MeshGenerator.d.ts +43 -0
  13. package/types/core/SpineMesh.d.ts +11 -0
  14. package/types/index.d.ts +9 -3
  15. package/types/renderer/SpineAnimationRenderer.d.ts +1 -1
  16. package/types/spine-core/Animation.d.ts +378 -0
  17. package/types/spine-core/AnimationState.d.ts +365 -0
  18. package/types/spine-core/AnimationStateData.d.ts +23 -0
  19. package/types/spine-core/AssetManager.d.ts +36 -0
  20. package/types/spine-core/AtlasAttachmentLoader.d.ts +23 -0
  21. package/types/spine-core/BlendMode.d.ts +7 -0
  22. package/types/spine-core/Bone.d.ts +110 -0
  23. package/types/spine-core/BoneData.d.ts +44 -0
  24. package/types/spine-core/ConstraintData.d.ts +7 -0
  25. package/types/spine-core/Event.d.ts +16 -0
  26. package/types/spine-core/EventData.d.ts +13 -0
  27. package/types/spine-core/IkConstraint.d.ts +38 -0
  28. package/types/spine-core/IkConstraintData.d.ts +26 -0
  29. package/types/spine-core/PathConstraint.d.ts +46 -0
  30. package/types/spine-core/PathConstraintData.d.ts +52 -0
  31. package/types/spine-core/SharedAssetManager.d.ts +19 -0
  32. package/types/spine-core/Skeleton.d.ts +134 -0
  33. package/types/spine-core/SkeletonBinary.d.ts +49 -0
  34. package/types/spine-core/SkeletonBounds.d.ts +48 -0
  35. package/types/spine-core/SkeletonClipping.d.ts +22 -0
  36. package/types/spine-core/SkeletonData.d.ts +89 -0
  37. package/types/spine-core/SkeletonJson.d.ts +34 -0
  38. package/types/spine-core/Skin.d.ts +43 -0
  39. package/types/spine-core/Slot.d.ts +42 -0
  40. package/types/spine-core/SlotData.d.ts +23 -0
  41. package/types/spine-core/Texture.d.ts +46 -0
  42. package/types/spine-core/TextureAtlas.d.ts +30 -0
  43. package/types/spine-core/TransformConstraint.d.ts +36 -0
  44. package/types/spine-core/TransformConstraintData.d.ts +34 -0
  45. package/types/spine-core/Triangulator.d.ts +14 -0
  46. package/types/spine-core/Updatable.d.ts +9 -0
  47. package/types/spine-core/Utils.d.ts +124 -0
  48. package/types/spine-core/VertexEffect.d.ts +7 -0
  49. package/types/spine-core/attachments/Attachment.d.ts +43 -0
  50. package/types/spine-core/attachments/AttachmentLoader.d.ts +25 -0
  51. package/types/spine-core/attachments/AttachmentType.d.ts +9 -0
  52. package/types/spine-core/attachments/BoundingBoxAttachment.d.ts +12 -0
  53. package/types/spine-core/attachments/ClippingAttachment.d.ts +14 -0
  54. package/types/spine-core/attachments/MeshAttachment.d.ts +46 -0
  55. package/types/spine-core/attachments/PathAttachment.d.ts +19 -0
  56. package/types/spine-core/attachments/PointAttachment.d.ts +20 -0
  57. package/types/spine-core/attachments/RegionAttachment.d.ts +88 -0
  58. package/types/spine-core/polyfills.d.ts +3 -0
  59. package/types/spine-core/vertexeffects/JitterEffect.d.ts +11 -0
  60. package/types/spine-core/vertexeffects/SwirlEffect.d.ts +16 -0
  61. package/types/types.d.ts +4 -0
  62. package/dist/miniprogram.js +0 -11748
package/package.json CHANGED
@@ -1,78 +1,45 @@
1
1
  {
2
- "version": "0.0.0-experimental-engine-spine-4.2.1",
2
+ "version": "0.0.0-experimental-engine-spine-2025509",
3
3
  "description": "galacean spine runtime",
4
4
  "name": "@galacean/engine-spine",
5
5
  "main": "dist/main.js",
6
6
  "browser": "dist/browser.js",
7
7
  "module": "dist/module.js",
8
- "dependencies": {
9
- "@esotericsoftware/spine-core": "~4.2.66"
10
- },
8
+ "dependencies": {},
11
9
  "peerDependencies": {
12
- "@galacean/engine": ">=1.3.20"
10
+ "@galacean/engine": ">=1.1.0-beta.0"
13
11
  },
14
12
  "devDependencies": {
15
- "@babel/core": "^7.26.0",
16
- "@babel/plugin-proposal-class-properties": "^7.18.6",
17
- "@babel/plugin-proposal-decorators": "^7.25.9",
18
- "@babel/plugin-proposal-optional-chaining": "^7.21.0",
19
- "@babel/plugin-transform-class-properties": "^7.25.9",
20
- "@babel/plugin-transform-object-assign": "^7.25.9",
21
- "@babel/preset-env": "^7.26.0",
22
- "@babel/preset-typescript": "^7.26.0",
23
- "@galacean/engine": "^1.3.24",
24
- "@galacean/engine-toolkit": "beta",
25
- "@rollup/plugin-babel": "^5.3.1",
13
+ "@babel/core": "^7.22.5",
14
+ "@babel/plugin-proposal-class-properties": "^7.12.1",
15
+ "@babel/plugin-proposal-decorators": "^7.12.1",
16
+ "@babel/plugin-proposal-optional-chaining": "^7.12.1",
17
+ "@babel/plugin-transform-object-assign": "^7.12.1",
18
+ "@babel/preset-env": "^7.12.1",
19
+ "@babel/preset-typescript": "^7.12.1",
20
+ "@galacean/engine": "1.1.3",
21
+ "@galacean/engine-toolkit": "^1.1.0-beta.0",
22
+ "@rollup/plugin-babel": "^5.2.1",
26
23
  "@rollup/plugin-commonjs": "^16.0.0",
27
- "@rollup/plugin-inject": "^4.0.4",
24
+ "@rollup/plugin-inject": "^4.0.2",
28
25
  "@rollup/plugin-node-resolve": "^10.0.0",
29
- "@rollup/plugin-replace": "^2.4.2",
30
- "@rollup/plugin-terser": "^0.4.4",
31
- "@swc/core": "^1.9.3",
32
- "@swc/helpers": "^0.5.15",
33
- "@types/chai": "^4.3.20",
34
- "@types/jest": "^29.5.14",
35
- "@types/node": "^20.17.9",
36
- "@vitejs/plugin-basic-ssl": "^1.2.0",
37
- "babel-core": "^6.26.3",
38
- "babel-jest": "^29.7.0",
39
- "chai": "^4.5.0",
40
- "chai-spies": "^1.1.0",
41
- "cross-env": "^5.2.1",
42
- "cypress": "^13.16.0",
43
- "cypress-recurse": "^1.35.3",
26
+ "@rollup/plugin-replace": "^2.3.4",
27
+ "@rollup/plugin-terser": "^0.4.3",
28
+ "@swc/core": "^1.3.32",
29
+ "@swc/helpers": "^0.5",
30
+ "cross-env": "^5.2.0",
44
31
  "dat.gui": "^0.7.9",
45
- "jest": "^29.7.0",
46
- "jest-environment-jsdom": "^29.7.0",
47
- "jest-webgl-canvas-mock": "^2.5.3",
48
- "nock": "^13.5.6",
49
- "odiff-bin": "^3.2.0",
50
32
  "react": "^16.14.0",
51
33
  "react-dom": "^16.14.0",
52
- "regenerator-runtime": "^0.14.1",
53
- "rollup": "^2.79.2",
54
- "rollup-plugin-glslify": "^1.3.1",
34
+ "rollup": "^2.32.0",
35
+ "rollup-plugin-glslify": "^1.2.0",
55
36
  "rollup-plugin-modify": "^3.0.0",
56
- "rollup-plugin-serve": "^1.1.1",
57
- "rollup-plugin-swc3": "^0.12.1",
37
+ "rollup-plugin-serve": "^1.1.0",
38
+ "rollup-plugin-swc3": "^0.8.0",
58
39
  "rollup-plugin-terser": "^7.0.2",
59
40
  "rollup-plugin-version-injector": "^1.3.3",
60
- "sass": "^1.81.1",
61
- "sinon": "^18.0.1",
62
- "ts-jest": "^29.2.5",
63
- "ts-node": "^10.9.2",
64
- "tsconfig-paths": "^4.2.0",
65
- "typescript": "^5.5.3",
66
- "vite": "^5.3.4",
67
- "husky": "^8.0.3",
68
- "lint-staged": "^10.5.4",
69
- "@typescript-eslint/eslint-plugin": "^6.21.0",
70
- "@typescript-eslint/parser": "^6.21.0",
71
- "eslint": "^8.57.1",
72
- "eslint-config-prettier": "^8.10.0",
73
- "eslint-plugin-prettier": "^5.2.1",
74
- "@commitlint/cli": "^11.0.0",
75
- "@commitlint/config-conventional": "^11.0.0"
41
+ "typescript": "^4.8.4",
42
+ "vite": "^4.3.9"
76
43
  },
77
44
  "ci": {
78
45
  "type": "aci",
@@ -82,49 +49,15 @@
82
49
  "types",
83
50
  "dist"
84
51
  ],
85
- "jest": {
86
- "runner": "jest-runner",
87
- "testEnvironment": "jsdom",
88
- "testEnvironmentOptions": {
89
- "url": "https://mdn.alipayobjects.com/",
90
- "userAgent": "Agent/007"
91
- },
92
- "preset": "ts-jest",
93
- "collectCoverage": true,
94
- "testRegex": "(/tests/.*\\.(test|spec))\\.ts?$",
95
- "collectCoverageFrom": [
96
- "src/**/*.ts"
97
- ],
98
- "transform": {
99
- "^.+\\.js$": "babel-jest",
100
- "^.+\\.ts$": "ts-jest"
101
- },
102
- "transformIgnorePatterns": [
103
- "node_modules/(?!(.*@esotericsoftware/spine-core.*))"
104
- ],
105
- "setupFilesAfterEnv": [
106
- "./jest.setup.ts",
107
- "jest-webgl-canvas-mock"
108
- ]
109
- },
110
52
  "scripts": {
111
53
  "example": "vite",
112
54
  "test": "jest",
113
- "test:cov": "jest --coverage",
114
- "test:debug": "cross-env DEBUG_MODE=1 jest",
115
- "e2e:case": "vite serve ./e2e/.dev --config ./e2e/.dev/vite.config.js",
116
- "e2e": "cypress run --browser chrome --headless",
117
- "e2e:debug": "cypress open",
55
+ "test-cov": "jest --coverage",
118
56
  "dev": "rollup -cw",
119
57
  "build": "npm run b:types && cross-env BUILD_TYPE=ALL rollup -c",
120
- "build:watch": "npm run b:types && cross-env BUILD_TYPE=ALL rollup -c --watch",
121
58
  "ci": "npm run lint && npm run test-cov",
122
59
  "lint": "eslint src --fix --ext .ts,.tsx",
123
- "b:types": "tsc",
124
- "prepare": "husky install"
125
- },
126
- "lint-staged": {
127
- "*.{ts,tsx}": ["eslint --fix"]
60
+ "b:types": "tsc --emitDeclarationOnly"
128
61
  },
129
62
  "types": "types/index.d.ts",
130
63
  "repository": "https://github.com/johanzhu/engine-spine.git"
@@ -0,0 +1,48 @@
1
+ import { Skeleton } from "./spine-core/Skeleton";
2
+ import { SkeletonData } from "./spine-core/SkeletonData";
3
+ import { AnimationState } from "./spine-core/AnimationState";
4
+ import { MeshGenerator } from "./core/MeshGenerator";
5
+ import { SpineRenderSetting } from "./types";
6
+ import { Script, Entity, Texture2D, Material, Engine } from "@galacean/engine";
7
+ export declare class SpineAnimation extends Script {
8
+ /** Spine 材质 */
9
+ private static _defaultMaterial;
10
+ static getDefaultMaterial(engine: Engine): Material;
11
+ /** @internal */
12
+ _heldTextures: Texture2D[];
13
+ private _skeletonData;
14
+ private _skeleton;
15
+ private _state;
16
+ private _tempOffset;
17
+ private _tempSize;
18
+ private _tempArray;
19
+ protected _meshGenerator: MeshGenerator;
20
+ setting: SpineRenderSetting;
21
+ autoUpdateBounds: boolean;
22
+ noPause: boolean;
23
+ get skeletonData(): SkeletonData;
24
+ get skeleton(): Skeleton;
25
+ get state(): AnimationState;
26
+ get mesh(): import("@galacean/engine").BufferMesh;
27
+ set scale(v: number);
28
+ constructor(entity: Entity);
29
+ setSkeletonData(skeletonData: SkeletonData, setting?: SpineRenderSetting): void;
30
+ /**
31
+ * Separate slot by slot name. This will add a new sub mesh, and new materials.
32
+ */
33
+ addSeparateSlot(slotName: string): void;
34
+ /**
35
+ * Change texture of a separated slot by name.
36
+ */
37
+ hackSeparateSlotTexture(slotName: string, texture: Texture2D): void;
38
+ onUpdate(delta: number): void;
39
+ updateGeometry(): void;
40
+ updateBounds(): void;
41
+ /**
42
+ * Spine animation custom clone.
43
+ */
44
+ _cloneTo(target: SpineAnimation): void;
45
+ private _disposeCurrentSkeleton;
46
+ private _disposeTextures;
47
+ onDestroy(): void;
48
+ }
@@ -0,0 +1,32 @@
1
+ import { AssetPromise, Loader, LoadItem, ResourceManager, TextureWrapMode, Texture2D, Entity, AssetType } from "@galacean/engine";
2
+ import { AssetManager } from "./spine-core/AssetManager";
3
+ import { Texture } from "./spine-core/Texture";
4
+ type SpineResouce = {
5
+ skeletonFile: string;
6
+ atlasFile: string;
7
+ textureFile?: string;
8
+ textureType?: AssetType;
9
+ };
10
+ type SpineOpt = {
11
+ scale: number;
12
+ };
13
+ type SpineLoadItem = LoadItem & SpineOpt;
14
+ declare class SpineLoader extends Loader<Entity> {
15
+ load(item: SpineLoadItem, resourceManager: ResourceManager): AssetPromise<Entity>;
16
+ handleResource(resourceManager: ResourceManager, item: SpineLoadItem, resource: SpineResouce, resolve: any, reject: any): void;
17
+ textureAssetPicker(assetManager: AssetManager, textureFile: string): any;
18
+ createAdaptiveTexture(texture: Texture2D): AdaptiveTexture;
19
+ isBinFile(url: string): boolean;
20
+ checkUrl(url: string): boolean;
21
+ getResouceFromUrl(url: any): SpineResouce;
22
+ checkUrls(urls: string[]): boolean;
23
+ getResouceFromUrls(urls: string[], type?: AssetType): SpineResouce;
24
+ getExtFromUrl(url: string): string;
25
+ }
26
+ export declare class AdaptiveTexture extends Texture {
27
+ constructor(texture: Texture2D);
28
+ setFilters(minFilter: any, magFilter: any): void;
29
+ setWraps(uWrap: TextureWrapMode, vWrap: TextureWrapMode): void;
30
+ dispose(): void;
31
+ }
32
+ export { SpineLoader };
@@ -0,0 +1,6 @@
1
+ import { Engine, Material } from "@galacean/engine";
2
+ export declare class SpineMaterial extends Material {
3
+ private static _spineVS;
4
+ private static _spineFS;
5
+ constructor(engine: Engine);
6
+ }
@@ -0,0 +1,38 @@
1
+ import { Script, Entity } from "@galacean/engine";
2
+ import { SpineAnimation } from "./SpineAnimation";
3
+ export declare class SpineRenderer extends Script {
4
+ private _priority;
5
+ private _resource;
6
+ private _animationName;
7
+ private _loop;
8
+ private _paused;
9
+ private _autoPlay;
10
+ private _skinName;
11
+ private _scale;
12
+ private _spineAnimation;
13
+ /** @internal */
14
+ _animationNames: Array<string>;
15
+ /** @internal */
16
+ _skinNames: Array<string>;
17
+ get priority(): number;
18
+ set priority(value: number);
19
+ get resource(): Entity | null;
20
+ set resource(value: Entity | null);
21
+ get animationName(): string;
22
+ set animationName(name: string);
23
+ get loop(): boolean;
24
+ set loop(value: boolean);
25
+ get paused(): boolean;
26
+ set paused(value: boolean);
27
+ get autoPlay(): boolean;
28
+ set autoPlay(value: boolean);
29
+ get skinName(): string;
30
+ set skinName(name: string);
31
+ get scale(): number;
32
+ set scale(value: number);
33
+ get spineAnimation(): SpineAnimation;
34
+ onDestroy(): void;
35
+ play(name?: string, loop?: boolean): void;
36
+ _cloneTo(target: SpineRenderer): void;
37
+ private _removeResource;
38
+ }
@@ -0,0 +1,43 @@
1
+ import { Engine, Entity, SubMesh, Texture2D } from "@galacean/engine";
2
+ import { Skeleton } from "../spine-core/Skeleton";
3
+ import { SkeletonData } from "../spine-core/SkeletonData";
4
+ import { Color } from "../spine-core/Utils";
5
+ import { SpineRenderSetting } from "../types";
6
+ import { BlendMode } from "../spine-core/BlendMode";
7
+ type SubMeshItem = {
8
+ subMesh: SubMesh;
9
+ blendMode: BlendMode;
10
+ texture: any;
11
+ slotName?: string;
12
+ };
13
+ export declare class MeshGenerator {
14
+ static QUAD_TRIANGLES: number[];
15
+ static VERTEX_SIZE: number;
16
+ static VERTEX_STRIDE: number;
17
+ static tempColor: Color;
18
+ static tempBlendMode: BlendMode | null;
19
+ private _setting;
20
+ private _engine;
21
+ private _entity;
22
+ private _clipper;
23
+ private _spineMesh;
24
+ private _vertexCount;
25
+ private _vertices;
26
+ private _verticesWithZ;
27
+ private _indices;
28
+ private _needResize;
29
+ private _meshRenderer;
30
+ private _subMeshItems;
31
+ readonly separateSlots: string[];
32
+ readonly separateSlotTextureMap: Map<string, Texture2D>;
33
+ get mesh(): import("@galacean/engine").BufferMesh;
34
+ get subMeshItems(): SubMeshItem[];
35
+ constructor(engine: Engine, entity: Entity);
36
+ initialize(skeletonData: SkeletonData, setting?: SpineRenderSetting): void;
37
+ buildMesh(skeleton: Skeleton): void;
38
+ addSeparateSlot(slotName: string): void;
39
+ addSeparateSlotTexture(slotName: string, texture: Texture2D): void;
40
+ private _prepareBufferData;
41
+ private setBlendMode;
42
+ }
43
+ export {};
@@ -0,0 +1,11 @@
1
+ import { BufferMesh, Engine, Buffer } from '@galacean/engine';
2
+ export declare class SpineMesh {
3
+ private _mesh;
4
+ private _indexBuffer;
5
+ private _vertexBuffer;
6
+ get mesh(): BufferMesh;
7
+ get indexBuffer(): Buffer;
8
+ get vertexBuffer(): Buffer;
9
+ initialize(engine: Engine, vertexCount: number): void;
10
+ changeBuffer(engine: Engine, vertexCount: number): void;
11
+ }
package/types/index.d.ts CHANGED
@@ -1,4 +1,10 @@
1
- export * from "@esotericsoftware/spine-core";
2
- export * from "./loader/index";
3
- export * from "./renderer/index";
1
+ import "./SpineLoader";
2
+ export { SpineRenderer } from "./SpineRenderer";
3
+ export { SpineAnimation } from "./SpineAnimation";
4
+ export { AssetManager } from "./spine-core/AssetManager";
5
+ export { Texture } from "./spine-core/Texture";
6
+ export { TextureAtlas } from "./spine-core/TextureAtlas";
7
+ export { AtlasAttachmentLoader } from "./spine-core/AtlasAttachmentLoader";
8
+ export { SkeletonJson } from "./spine-core/SkeletonJson";
9
+ export { SkeletonBinary } from "./spine-core/SkeletonBinary";
4
10
  export declare const version = "__buildVersion";
@@ -15,7 +15,7 @@ export declare class SpineAnimationRenderer extends Renderer {
15
15
  /** @internal */
16
16
  static _getDefaultMaterial(engine: Engine): Material;
17
17
  /**
18
- * The spacing between z layers.
18
+ * The spacing between z layers in world units.
19
19
  */
20
20
  zSpacing: number;
21
21
  /**