@galacean/effects-helper 0.0.1-alpha.0

package/README.md

@@ -0,0 +1 @@
+# Galacean Effects Helper

package/dist/index.d.ts

@@ -0,0 +1 @@
+export * from './serialize';

package/dist/index.mjs

@@ -0,0 +1,508 @@
+/*!
+ * Name: @galacean/effects-helper
+ * Description: Galacean Effects runtime helper for the web
+ * Author: Ant Group CO., Ltd.
+ * Contributors: 燃然,意绮
+ * Version: v0.0.1-alpha.0
+ */
+
+import { spec } from '@galacean/effects';
+
+/******************************************************************************
+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.
+***************************************************************************** */
+
+var __assign = function() {
+    __assign = Object.assign || function __assign(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p)) t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+
+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());
+    });
+}
+
+function __generator(thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+}
+
+function __read(o, n) {
+    var m = typeof Symbol === "function" && o[Symbol.iterator];
+    if (!m) return o;
+    var i = m.call(o), r, ar = [], e;
+    try {
+        while ((n === void 0 || n-- > 0) && !(r = i.next()).done) ar.push(r.value);
+    }
+    catch (error) { e = { error: error }; }
+    finally {
+        try {
+            if (r && !r.done && (m = i["return"])) m.call(i);
+        }
+        finally { if (e) throw e.error; }
+    }
+    return ar;
+}
+
+function __spreadArray(to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+}
+
+typeof SuppressedError === "function" ? SuppressedError : function (error, suppressed, message) {
+    var e = new Error(message);
+    return e.name = "SuppressedError", e.error = error, e.suppressed = suppressed, e;
+};
+
+function loadMipmaps(textureOptions, dataIndex) {
+    return __awaiter(this, void 0, void 0, function () {
+        var mipmaps, cube, textureCubeMipmaps, jobs, newMipmaps, images, result, cubeMipmaps, i, mipmap, mipmapPointers, j, pointer;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    mipmaps = textureOptions.mipmaps;
+                    cube = textureOptions.cube;
+                    textureCubeMipmaps = mipmaps || [cube];
+                    jobs = textureCubeMipmaps.map(function (mipmap) { return Promise.all(mipmap.map(function (imageLike) {
+                        if (imageLike instanceof HTMLImageElement) {
+                            return getImageFileContent(imageLike);
+                        }
+                        return Promise.reject('invalid image format');
+                    })); });
+                    return [4 /*yield*/, Promise.all(jobs)];
+                case 1:
+                    newMipmaps = _a.sent();
+                    images = [];
+                    newMipmaps.forEach(function (mipmap) { return images.push.apply(images, __spreadArray([], __read(mipmap), false)); });
+                    result = concatArrayBuffers(images);
+                    cubeMipmaps = [];
+                    for (i = 0; i < textureCubeMipmaps.length; i++) {
+                        mipmap = textureCubeMipmaps[i];
+                        mipmapPointers = [];
+                        for (j = 0; j < mipmap.length; j++) {
+                            pointer = mipmapPointers[j] = result.pointers[i * 6 + j];
+                            pointer[1][0] = dataIndex;
+                        }
+                        cubeMipmaps.push(mipmapPointers);
+                    }
+                    return [2 /*return*/, {
+                            data: result.data,
+                            mipmaps: cubeMipmaps,
+                        }];
+            }
+        });
+    });
+}
+function getImageFileContent(image) {
+    var _a;
+    return __awaiter(this, void 0, void 0, function () {
+        var canvas;
+        return __generator(this, function (_b) {
+            canvas = document.createElement('canvas');
+            canvas.width = image.width;
+            canvas.height = image.height;
+            (_a = canvas.getContext('2d')) === null || _a === void 0 ? void 0 : _a.drawImage(image, 0, 0);
+            return [2 /*return*/, new Promise(function (resolve, reject) {
+                    canvas.toBlob(function (blob) {
+                        if (blob) {
+                            resolve(blob.arrayBuffer());
+                        }
+                        else {
+                            reject(Error('no canvas blob'));
+                        }
+                    }, 'image/png', 1);
+                })];
+        });
+    });
+}
+function concatBuffers(buffers, bufferInfo, length) {
+    var ret = new Uint8Array(length);
+    buffers.forEach(function (buffer) {
+        var _a = __read(bufferInfo.get(buffer), 3), offset = _a[1], byteLength = _a[2];
+        var source = buffer instanceof ArrayBuffer ? new Uint8Array(buffer, 0, byteLength) : new Uint8Array(buffer.buffer, buffer.byteOffset, byteLength);
+        ret.set(source, offset);
+    });
+    return ret.buffer;
+}
+function getBinaryType(arr) {
+    if (arr instanceof Uint8Array) {
+        return 'u8';
+    }
+    else if (arr instanceof Int8Array) {
+        return 'i8';
+    }
+    else if (arr instanceof Uint16Array) {
+        return 'u16';
+    }
+    else if (arr instanceof Int16Array) {
+        return 'i16';
+    }
+    else if (arr instanceof Uint32Array) {
+        return 'u32';
+    }
+    else if (arr instanceof Int32Array) {
+        return 'i32';
+    }
+    else if (arr instanceof Float32Array) {
+        return 'f32';
+    }
+    return '';
+}
+/**
+ * 工具方法，按照 4bytes 对齐方式合并 buffers，如果提供了 pointer，会把原来的 pointer 转化为新的映射
+ * 返回的 pointers 数组和传入的 pointers 数组长度一致，并且一一对应
+ * @internal
+ * @param buffers
+ * @param pointers - 如果不提供 pointers，将返回整段 buffers 的 pointer 重映射
+ * @param overwrite - 如果为 true，将直接改写参数中的 pointer 值，否则生成新的 pointer 传出
+ */
+function concatArrayBuffers(buffers, pointers, overwrite) {
+    var bufferInfo = new Map();
+    var offset = 0;
+    for (var i = 0; i < buffers.length; i++) {
+        var buffer = buffers[i];
+        var content = [0, offset, buffer.byteLength];
+        var type = getBinaryType(buffer);
+        if (type) {
+            content[3] = type;
+        }
+        bufferInfo.set(buffer, content);
+        offset += buffer.byteLength;
+        // padding 4bytes for f32
+        offset = Math.ceil(offset / 4) * 4;
+    }
+    if (!pointers) {
+        pointers = buffers.map(function (buffer, i) {
+            return [spec.ValueType.BINARY, [i, 0, buffer.byteLength]];
+        });
+    }
+    var retBuffer = concatBuffers(buffers, bufferInfo, offset);
+    var mappedPointers = pointers.map(function (pointer) {
+        var _a;
+        var content = pointer[1];
+        var buffer = buffers[content[0]];
+        if (!buffer) {
+            throw new Error("buffer index ".concat(content[0], " not found"));
+        }
+        var originStart = content[1] || 0;
+        var byteLength = content[2] || (buffer.byteLength - originStart);
+        var info = (_a = bufferInfo.get(buffer)) !== null && _a !== void 0 ? _a : [];
+        // @ts-expect-error
+        var binaryPointerContent = [0, originStart + info[1], byteLength];
+        if (info[3]) {
+            binaryPointerContent[3] = info[3];
+        }
+        if (overwrite) {
+            pointer[1] = binaryPointerContent;
+            return pointer;
+        }
+        return [spec.ValueType.BINARY, binaryPointerContent];
+    });
+    return {
+        data: retBuffer,
+        pointers: mappedPointers,
+    };
+}
+
+var TextureSourceTypeImage = 2;
+/**
+ * texture 序列化
+ * @param textureOptions
+ */
+function serializeTextures(textureOptions) {
+    return __awaiter(this, void 0, void 0, function () {
+        var imageBufferSet, filesPending, cubesPending, imageMap, cubeMap, _loop_1, i, files, images, resultTextures, bins, tex, i, texture, info, buffer;
+        var _this = this;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    imageBufferSet = new Map();
+                    filesPending = [];
+                    cubesPending = [];
+                    imageMap = new Map();
+                    cubeMap = new Map();
+                    _loop_1 = function (i) {
+                        var texture = textureOptions[i];
+                        var sourceFrom = texture.sourceFrom;
+                        var target = texture.target;
+                        var image = texture.image;
+                        if (sourceFrom &&
+                            sourceFrom.type === TextureSourceTypeImage &&
+                            sourceFrom.target !== WebGLRenderingContext.TEXTURE_CUBE_MAP) {
+                            var url_1 = sourceFrom.url;
+                            var job = function () { return __awaiter(_this, void 0, void 0, function () {
+                                var result, buffer;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, fetch(url_1)];
+                                        case 1:
+                                            result = _a.sent();
+                                            return [4 /*yield*/, result.arrayBuffer()];
+                                        case 2:
+                                            buffer = _a.sent();
+                                            imageMap.set(texture, buffer);
+                                            return [2 /*return*/, buffer];
+                                    }
+                                });
+                            }); };
+                            filesPending.push(job());
+                            return "continue";
+                        }
+                        if (target === WebGLRenderingContext.TEXTURE_CUBE_MAP) {
+                            var job = function () { return __awaiter(_this, void 0, void 0, function () {
+                                var result;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, loadMipmaps(texture, cubesPending.length)];
+                                        case 1:
+                                            result = _a.sent();
+                                            cubeMap.set(texture, result);
+                                            return [2 /*return*/];
+                                    }
+                                });
+                            }); };
+                            cubesPending.push(job());
+                            return "continue";
+                        }
+                        if (image instanceof HTMLImageElement) {
+                            var url_2 = image.src;
+                            if (!imageBufferSet.has(url_2)) {
+                                imageBufferSet.set(url_2, getImageFileContent(image));
+                            }
+                            var job = function () { return __awaiter(_this, void 0, void 0, function () {
+                                var buffer;
+                                return __generator(this, function (_a) {
+                                    switch (_a.label) {
+                                        case 0: return [4 /*yield*/, imageBufferSet.get(url_2)];
+                                        case 1:
+                                            buffer = _a.sent();
+                                            imageMap.set(texture, buffer);
+                                            return [2 /*return*/, buffer];
+                                    }
+                                });
+                            }); };
+                            filesPending.push(job());
+                        }
+                        else {
+                            throw new Error("tex ".concat(i, " image should be HTMLImage or HTMLCanvas"));
+                        }
+                    };
+                    for (i = 0; i < textureOptions.length; i++) {
+                        _loop_1(i);
+                    }
+                    return [4 /*yield*/, Promise.all(cubesPending)];
+                case 1:
+                    _a.sent();
+                    return [4 /*yield*/, Promise.all(filesPending)];
+                case 2:
+                    files = _a.sent();
+                    images = Array.from(new Set(files));
+                    resultTextures = [];
+                    bins = [];
+                    for (i = 0; i < textureOptions.length; i++) {
+                        texture = textureOptions[i];
+                        if (texture.target === WebGLRenderingContext.TEXTURE_CUBE_MAP) {
+                            info = cubeMap.get(texture);
+                            bins.push(info.data);
+                            tex = __assign(__assign({}, texture), { mipmaps: info.mipmaps, sourceType: 7 });
+                            if ('cube' in tex) {
+                                delete tex.cube;
+                            }
+                        }
+                        else {
+                            buffer = imageMap.get(texture);
+                            tex = __assign(__assign({}, texture), { source: images.indexOf(buffer) });
+                            if ('mipmaps' in tex) {
+                                // @ts-expect-error
+                                delete tex.mipmaps;
+                            }
+                        }
+                        if ('sourceFrom' in tex) {
+                            delete tex.sourceFrom;
+                        }
+                        if ('image' in tex) {
+                            delete tex.image;
+                        }
+                        resultTextures.push(tex);
+                    }
+                    return [2 /*return*/, {
+                            version: '1.0',
+                            images: images,
+                            bins: bins,
+                            textures: resultTextures,
+                        }];
+            }
+        });
+    });
+}
+
+/**
+ * geometry 序列化
+ * @param geometries
+ */
+function serializeGeometries(geometries) {
+    var buffers = [];
+    var bufferInfo = new Map();
+    var offset = 0;
+    geometries.forEach(function (options) {
+        var _a;
+        addBuffer((_a = options.indices) === null || _a === void 0 ? void 0 : _a.data);
+        Object.values(options.attributes).forEach(function (attribute) {
+            var data = attribute.data;
+            addBuffer(data);
+        });
+    });
+    var resultBuffer = concatBuffers(buffers, bufferInfo, offset);
+    var mappedGeometries = geometries.map(function (props) {
+        var geometryProps = __assign({}, props);
+        if (geometryProps.indices) {
+            geometryProps.indices = replaceAttribute(geometryProps.indices);
+        }
+        geometryProps.attributes = {};
+        Object.keys(props.attributes).forEach(function (name) {
+            var attribute = props.attributes[name];
+            geometryProps.attributes[name] = replaceAttribute(attribute);
+        });
+        return geometryProps;
+    });
+    return {
+        data: resultBuffer,
+        geometries: mappedGeometries,
+        version: '1.0',
+    };
+    function addBuffer(buffer) {
+        if (buffer && !buffers.includes(buffer)) {
+            buffers.push(buffer);
+            bufferInfo.set(buffer, [0, offset, buffer.byteLength, getBinaryType(buffer)]);
+            offset += buffer.byteLength;
+            // padding 4bytes for f32
+            offset = Math.ceil(offset / 4) * 4;
+        }
+    }
+    function replaceAttribute(attr) {
+        var source;
+        if (attr.data) {
+            var info = bufferInfo.get(attr.data);
+            if (info) {
+                source = { data: [spec.ValueType.BINARY, info] };
+            }
+        }
+        return __assign(__assign({}, attr), source);
+    }
+}
+/**
+ * geometry 反序列化
+ * @param geometryProps
+ * @param data
+ */
+function deserializeGeometry(geometryProps, data) {
+    var _a, _b;
+    var attributes = geometryProps.attributes;
+    var ret = __assign({}, geometryProps);
+    if (ret.indices) {
+        ret.indices = __assign({}, ret.indices);
+        if (ret.indices.data) {
+            // @ts-expect-error
+            ret.indices.data = typedArrayFromBinary(data, (_a = geometryProps.indices) === null || _a === void 0 ? void 0 : _a.data);
+        }
+        // @ts-expect-error
+    }
+    else if (ret.index) {
+        // FIXME: 兼容编辑器导出的旧版数据
+        // @ts-expect-error
+        ret.indices = __assign({}, ret.index);
+        // @ts-expect-error
+        if (ret.indices.data) {
+            // @ts-expect-error
+            ret.indices.data = typedArrayFromBinary(data, (_b = geometryProps.index) === null || _b === void 0 ? void 0 : _b.data);
+        }
+    }
+    Object.keys(attributes).forEach(function (name) {
+        var attribute = attributes[name];
+        var pointer = attribute.data;
+        ret.attributes[name] = __assign({}, attribute);
+        if (pointer) {
+            ret.attributes[name].data = typedArrayFromBinary(data, pointer);
+        }
+    });
+    return ret;
+}
+var ctrlMap = {
+    i8: Int8Array,
+    u8: Uint8Array,
+    i16: Int16Array,
+    u16: Uint16Array,
+    f32: Float32Array,
+    i32: Int32Array,
+    u32: Uint32Array,
+};
+/**
+ * 重构 TypedArray，返回的 TypedArray 如果修改，会反映到原始的 ArrayBuffer 中
+ * @param binaries
+ * @param pointer
+ */
+function typedArrayFromBinary(binary, pointer) {
+    if (pointer.length != 2 || pointer[0] !== spec.ValueType.BINARY || !(pointer[1] instanceof Array)) {
+        // 不是BinaryPointer，可能已经创建，直接返回
+        return pointer;
+    }
+    var _a = __read(pointer[1], 4), index = _a[0], start = _a[1], byteLength = _a[2], type = _a[3];
+    if (!type) {
+        return binary[index].slice(start, byteLength);
+    }
+    var CTRL = ctrlMap[type] || Uint8Array;
+    return new CTRL(binary[index], start, byteLength / CTRL.BYTES_PER_ELEMENT);
+}
+
+export { concatArrayBuffers, concatBuffers, deserializeGeometry, getBinaryType, getImageFileContent, loadMipmaps, serializeGeometries, serializeTextures, typedArrayFromBinary };
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/serialize/geometry.d.ts

@@ -0,0 +1,24 @@
+import { spec } from '@galacean/effects';
+import type { GeometryProps } from '@galacean/effects';
+export interface GeometrySerializationResult {
+    version: '1.0';
+    data: ArrayBuffer;
+    geometries: spec.GeometryOptionsJSON[];
+}
+/**
+ * geometry 序列化
+ * @param geometries
+ */
+export declare function serializeGeometries(geometries: GeometryProps[]): GeometrySerializationResult;
+/**
+ * geometry 反序列化
+ * @param geometryProps
+ * @param data
+ */
+export declare function deserializeGeometry(geometryProps: spec.GeometryOptionsJSON, data: ArrayBuffer[]): GeometryProps;
+/**
+ * 重构 TypedArray，返回的 TypedArray 如果修改，会反映到原始的 ArrayBuffer 中
+ * @param binaries
+ * @param pointer
+ */
+export declare function typedArrayFromBinary(binary: ArrayBuffer[], pointer: spec.BinaryPointer): spec.TypedArray | ArrayBuffer;

package/dist/serialize/index.d.ts

@@ -0,0 +1,3 @@
+export * from './texture';
+export * from './geometry';
+export * from './utils';

package/dist/serialize/texture.d.ts

@@ -0,0 +1,12 @@
+import type { Texture2DSourceOptions, TextureCubeSourceOptions, spec } from '@galacean/effects';
+export interface TextureSerializationResult {
+    version: '1.0';
+    bins?: ArrayBuffer[];
+    images: ArrayBuffer[];
+    textures: spec.TextureJSONOptions[];
+}
+/**
+ * texture 序列化
+ * @param textureOptions
+ */
+export declare function serializeTextures(textureOptions: (Texture2DSourceOptions | TextureCubeSourceOptions)[]): Promise<TextureSerializationResult>;

package/dist/serialize/utils.d.ts

@@ -0,0 +1,21 @@
+import { spec } from '@galacean/effects';
+import type { TextureCubeSourceOptionsImage, TextureCubeSourceOptionsImageMipmaps } from '@galacean/effects';
+export declare function loadMipmaps(textureOptions: TextureCubeSourceOptionsImageMipmaps | TextureCubeSourceOptionsImage, dataIndex: number): Promise<{
+    data: ArrayBuffer;
+    mipmaps: spec.SerializedTextureCubeMipmap[];
+}>;
+export declare function getImageFileContent(image: HTMLImageElement | ImageBitmap | HTMLVideoElement): Promise<ArrayBuffer>;
+export declare function concatBuffers(buffers: (spec.TypedArray | ArrayBuffer)[], bufferInfo: Map<spec.TypedArray | ArrayBuffer, spec.BinaryPointerContent>, length: number): ArrayBuffer;
+export declare function getBinaryType(arr: spec.TypedArray | ArrayBuffer): spec.BinaryType;
+/**
+ * 工具方法，按照 4bytes 对齐方式合并 buffers，如果提供了 pointer，会把原来的 pointer 转化为新的映射
+ * 返回的 pointers 数组和传入的 pointers 数组长度一致，并且一一对应
+ * @internal
+ * @param buffers
+ * @param pointers - 如果不提供 pointers，将返回整段 buffers 的 pointer 重映射
+ * @param overwrite - 如果为 true，将直接改写参数中的 pointer 值，否则生成新的 pointer 传出
+ */
+export declare function concatArrayBuffers(buffers: (spec.TypedArray | ArrayBuffer)[], pointers?: spec.BinaryPointer[], overwrite?: boolean): {
+    data: ArrayBuffer;
+    pointers: spec.BinaryPointer[];
+};

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@galacean/effects-helper",
+  "version": "0.0.1-alpha.0",
+  "description": "Galacean Effects runtime helper for the web",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.mjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "contributors": [
+    {
+      "name": "燃然"
+    },
+    {
+      "name": "意绮"
+    }
+  ],
+  "author": "Ant Group CO., Ltd.",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "devDependencies": {
+    "@galacean/effects": "0.0.1-alpha.0"
+  },
+  "scripts": {
+    "prebuild": "pnpm clean",
+    "build": "pnpm build:declaration && pnpm build:module",
+    "build:module": "rollup -c",
+    "build:declaration": "tsc -d --declarationDir dist --emitDeclarationOnly",
+    "clean": "rimraf dist && rimraf '*+(.tsbuildinfo)'"
+  }
+}