lyb-pixi-js 1.9.6 → 1.9.7

package/Components/Custom/LibPixiSlide.d.ts

@@ -27,7 +27,7 @@ export interface LibPixiSlideParams {
     scrollCallback?: (x: number, index: number) => void;
 }
 /** @description 滑动页
- * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollNum-数字滑动
+ * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlide-滑动页
  */
 export declare class LibPixiSlide extends LibPixiContainer {
     /** 滑动加速度触发翻页 */

package/Components/Custom/LibPixiSlide.js

@@ -3,7 +3,7 @@ import gsap from "gsap";
 import { LibPixiContainer } from "../Base/LibPixiContainer";
 import { libPixiEvent } from "../../Utils/LibPixiEvent";
 /** @description 滑动页
- * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollNum-数字滑动
+ * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlide-滑动页
  */
 export class LibPixiSlide extends LibPixiContainer {
     constructor(params) {

package/README.md

@@ -120,6 +120,8 @@ app.stage.addChild(box);
 
 \- [LibPixiSlider-横向滑动图](#LibPixiSlider-横向滑动图)
 
+\- [LibPixiSlide-滑动页](#LibPixiSlide-滑动页)
+
 \- [LibPixiSubAddMinMax-数字控制器](#LibPixiSubAddMinMax-数字控制器)
 
 \- [LibPixiTable-数字表格](#LibPixiTable-数字表格)
@@ -162,6 +164,8 @@ app.stage.addChild(box);
 
 \- [LibPixiGridLayout-网格布局](#LibPixiGridLayout-网格布局)
 
+\- [LibArrangeLinear-间隔布局](#LibArrangeLinear-间隔布局)
+
 ## Base-基础
 
 ### LibPixiText-文本
@@ -787,6 +791,32 @@ slider.prev();
 slider.next();
 ```
 
+### LibPixiSlide-滑动页
+
+> `LibPixiSlider-横向滑动图`和`LibPixiScrollNum-数字滑动`的替代品，支持`X`和`Y`配置，景深
+
+```ts
+const three = new LibPixiSlide({
+  stage: gameMount.gameStage,
+  direction: "y",
+  width: 255,
+  height: 320,
+  pageHeight: 70,
+  content: threeList,
+  itemList: threeTextList,
+
+  scrollCallback: (y, index) => {
+    two.updatePosition(y, index);
+  },
+  depthCallback(container, getValue) {
+    const alpha = getValue(0.4);
+    const scaleY = getValue(0.1);
+    container.alpha = alpha;
+    container.scale.y = scaleY;
+  },
+});
+```
+
 ### LibPixiSubAddMinMax-数字控制器
 
 > 最小、最大按钮和增减按钮功能及置灰逻辑
@@ -1164,3 +1194,11 @@ LibPixiDownScaleAnimation(sprite);
 LibPixiGridLayout(cardList, 20, 3); //间隔20，一行三个
 ```
 
+### LibArrangeLinear-间隔布局
+
+> 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔
+
+```ts
+LibArrangeLinear(cardList, 20, "y"); //间隔20，y轴排列
+```
+

package/Utils/LibArrangeLinear.d.ts

@@ -0,0 +1,9 @@
+import { Container } from "pixi.js";
+/**
+ * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
+ * @param items 要排列的元素数组。
+ * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
+ * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
+ * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibArrangeLinear-间隔布局
+ */
+export declare const LibArrangeLinear: (items: Container[], gap: number | number[], direction?: "x" | "y") => void;

package/Utils/LibArrangeLinear.js

@@ -0,0 +1,29 @@
+/**
+ * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
+ * @param items 要排列的元素数组。
+ * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
+ * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
+ * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibArrangeLinear-间隔布局
+ */
+export const LibArrangeLinear = (items, gap, direction = "x") => {
+    if (Array.isArray(gap)) {
+        if (gap.length !== items.length - 1) {
+            console.error(new Error("间隔的数组长度只能等于元素数组长度-1"));
+            return;
+        }
+    }
+    let lastPosition = 0;
+    items.forEach((item, index) => {
+        const position = index === 0
+            ? 0
+            : lastPosition + (Array.isArray(gap) ? gap[index - 1] : gap);
+        if (direction === "x") {
+            item.x = position;
+            lastPosition = item.x + item.width;
+        }
+        else {
+            item.y = position;
+            lastPosition = item.y + item.height;
+        }
+    });
+};

package/libPixiJs.d.ts

@@ -27,116 +27,202 @@ import { LibPixiSlide } from "./Components/Custom/LibPixiSlide";
 /** @description 组件 */
 export declare const Components: {
     Base: {
-        /** @description 自定义位图文本 */
+        /** @description 自定义位图文本
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiBitText-位图
+         */
         LibPixiBitText: typeof LibPixiBitText;
-        /** @description 自定义容器大小及背景色 */
+        /** @description 自定义容器大小及背景色
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiContainer-容器
+         */
         LibPixiContainer: typeof LibPixiContainer;
-        /** @description 利用贝塞尔曲线实现粒子移动 */
+        /** @description 利用贝塞尔曲线实现粒子移动
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiParticleMove-粒子容器
+         */
         LibPixiParticleMove: typeof LibPixiParticleMove;
-        /** @description 自定义矩形背景色 */
+        /** @description 自定义矩形背景色
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiRectBgColor-矩形
+         */
         LibPixiRectBgColor: typeof LibPixiRectBgColor;
-        /** @description 矩形类，可用于一些场景的局部点击，传颜色是为了方便定位，最终可能需要将颜色隐藏掉 */
+        /** @description 矩形类，可用于一些场景的局部点击，传颜色是为了方便定位，最终可能需要将颜色隐藏掉
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiRectangle-矩形
+         */
         LibPixiRectangle: typeof LibPixiRectangle;
-        /** @description 圆形 */
+        /** @description 圆形
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCircular-圆形
+         */
         LibPixiCircular: typeof LibPixiCircular;
-        /** @description 多边形类 */
+        /** @description 多边形类
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPolygon-多边形
+         */
         LibPixiPolygon: typeof LibPixiPolygon;
-        /** @description 自定义 Spine 动画 */
+        /** @description 自定义 Spine 动画
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSpine-动画
+         */
         LibPixiSpine: typeof LibPixiSpine;
-        /** @description 自定义文本类 */
+        /** @description 自定义文本类
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiText-文本
+         */
         LibPixiText: typeof LibPixiText;
-        /** @description 自定义富文本类 */
+        /** @description 自定义富文本类
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiHtmlText-自定义富文本类
+         */
         LibPixiHtmlText: typeof LibPixiHtmlText;
     };
     Custom: {
-        /** @description 悬浮切换材质 */
+        /** @description 悬浮切换材质
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiButtonHover-按钮悬浮
+         */
         LibPixiButtonHover: typeof LibPixiButtonHover;
-        /** @description 右上角关闭按钮，支持悬浮旋转动画 */
+        /** @description 右上角关闭按钮，支持悬浮旋转动画
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCloseBtn-关闭按钮
+         */
         LibPixiCloseBtn: typeof LibPixiCloseBtn;
-        /** @description 底部弹出抽屉 */
+        /** @description 底部弹出抽屉
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDrawer-抽屉
+         */
         LibPixiDrawer: typeof LibPixiDrawer;
-        /** @description 监视帧率、Draw Call、Max Draw Call */
+        /** @description 监视帧率、Draw Call、Max Draw Call
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPerforMon-性能监视器
+         */
         LibPixiPerforMon: typeof LibPixiPerforMon;
-        /** @description 通过裁剪的方式显示进度条 */
+        /** @description 通过裁剪的方式显示进度条
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiProgress-进度条
+         */
         LibPixiProgress: typeof LibPixiProgress;
-        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹 */
+        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollContainerX-X轴滚动容器
+         */
         LibPixiScrollContainerX: typeof LibPixiScrollContainerX;
-        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹 */
+        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollContainerY-Y轴滚动容器
+         */
         LibPixiScrollContainerY: typeof LibPixiScrollContainerY;
-        /** @description 通过鼠标或手指拖动数字列选择数字 */
+        /** @description 通过鼠标或手指拖动数字列选择数字
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollNum-数字滑动
+         */
         LibPixiScrollNum: typeof LibPixiScrollNum;
-        /** @description 类似轮播图，但是不会自动轮播 */
+        /** @description 类似轮播图，但是不会自动轮播
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlider-横向滑动图
+         */
         LibPixiSlider: typeof LibPixiSlider;
-        /** @description 滑动页 */
+        /** @description 滑动页
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlide-滑动页
+         */
         LibPixiSlide: typeof LibPixiSlide;
-        /** @description 最小、最大按钮和增减按钮功能及置灰逻辑 */
+        /** @description 最小、最大按钮和增减按钮功能及置灰逻辑
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSubAddMinMax-数字控制器
+         */
         LibPixiSubAddMinMax: typeof LibPixiSubAddMinMax;
-        /** @description 绘制表格并填充数字 */
+        /** @description 绘制表格并填充数字
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiTable-数字表格
+         */
         LibPixiTable: typeof LibPixiTable;
     };
 };
 /** @description 方法 */
 export declare const Utils: {
-    /** @description 音频播放器 */
+    /** @description 音频播放器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiAudio-音频播放器
+     */
     LibPixiAudio: typeof LibPixiAudio;
-    /** @description 九宫格图 */
+    /** @description 九宫格图
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCreateNineGrid-九宫格图
+     */
     libPixiCreateNineGrid: (params: import("./Utils/LibPixiCreateNineGrid").LibPixiCreateNineGridParams) => import("pixi.js").NineSlicePlane;
     /** @description 事件注册
      * @param v 事件容器
      * @param eventName 事件名称
      * @param callback 回调函数
-     * @param once 是否只执行一次 */
+     * @param once 是否只执行一次
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiEvent-事件注册
+     */
     libPixiEvent: (v: import("pixi.js").Container, eventName: keyof import("pixi.js").DisplayObjectEvents, callback: (event: import("pixi.js").FederatedPointerEvent) => void, params?: import("./Utils/LibPixiEvent").LibPixiEventParams) => () => void;
     /** @description 滤镜
      * @param filterName 滤镜名称
-     * @param v 滤镜值 */
+     * @param v 滤镜值
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiFilter-滤镜
+     */
     libPixiFilter: (filterName: import("./Utils/LibPixiFilter").LibPixiSetFilterFilterName, v?: number) => import("pixi.js").ColorMatrixFilter | import("pixi.js").BlurFilter;
     /** @description 间隔触发
      * @param callback 回调函数
-     * @param interval 间隔毫秒，或随机范围 */
+     * @param interval 间隔毫秒，或随机范围
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiIntervalTrigger-间隔触发
+     */
     libPixiIntervalTrigger: (callback: () => void, interval: number | [number, number]) => () => void;
     /** @description 点击容器外或入口按钮时隐藏
      * @param container 容器
      * @param btn 按钮
-     * @param onClose 关闭回调 */
+     * @param onClose 关闭回调
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiOutsideClick-失焦隐藏
+     */
     libPixiOutsideClick: (container: import("pixi.js").Container, btn: import("pixi.js").Container, onClose: () => void) => () => void;
     /** @description 为容器创建并应用一个矩形遮罩，用于隐藏溢出的内容，函数会返回遮罩，可控制是否显示遮罩
-     * @param container 需要设置遮罩裁剪的容器 */
+     * @param container 需要设置遮罩裁剪的容器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiOverflowHidden-溢出裁剪
+     */
     libPixiOverflowHidden: (container: import("pixi.js").Container) => import("pixi.js").Graphics;
     /** @description 基于 Ticker 和 Promise 的定时器
      * @param delay 延迟时间
-     * @param callback 延迟后执行的函数 */
+     * @param callback 延迟后执行的函数
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPromiseTickerTimeout-TickerPromise定时器
+     */
     libPixiPromiseTickerTimeout: (delay?: number, callback?: () => void) => Promise<void>;
     /** @description 元素超过指定宽度就缩放
      * @param scaleContainer 需要缩放的元素
      * @param maxWidth 最大宽度
-     * @param maxHeight 最大高度 */
+     * @param maxHeight 最大高度
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScaleContainer-超出缩放
+     */
     libPixiScaleContainer: (scaleContainer: import("pixi.js").Container | import("pixi.js").Sprite | import("pixi.js").Text, maxWidth: number, maxHeight?: number) => void;
     /** @description 阴影
      * @param container 需要添加阴影的元素
-     * @param config 配置项 */
+     * @param config 配置项
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiShadow-阴影
+     */
     libPixiShadow: (container: import("pixi.js").Container, config?: import("./Utils/LibPixiShadow").LibPixiShadowShadowConfig) => void;
     /** @description 基于 Ticker 的定时器
      * @param callback 延迟后执行的函数
-     * @param delay 延迟时间 */
+     * @param delay 延迟时间
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiTickerTimeout-Ticker定时器
+     */
     libPixiTickerTimeout: (callback: () => void, delay?: number) => () => void;
-    /** @description 滑动选择器核心代码 */
+    /** @description 滑动选择器核心代码
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlideInput-滑动选择值
+     */
     LibPixiSlideInput: typeof LibPixiSlideInput;
-    /** @description 事件总线更新实例汇总 */
+    /** @description 事件总线更新实例汇总
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibGlobalUpdater-事件实例汇总
+     */
     LibPixiGlobalUpdater: typeof LibPixiGlobalUpdater;
-    /** @description 多边形绘制工具，绘制时浏览器窗口需要全屏显示，空格键控制开始和结束，开始后鼠标进行点击绘制，退格删除点，空格结束绘制，绘制结果在控制台打印，不满意可再次按空格清空并重新绘制 */
+    /** @description 多边形绘制工具，绘制时浏览器窗口需要全屏显示，空格键控制开始和结束，开始后鼠标进行点击绘制，退格删除点，空格结束绘制，绘制结果在控制台打印，不满意可再次按空格清空并重新绘制
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPolygonDrawTool-多边形绘制
+     */
     LibPixiPolygonDrawTool: typeof LibPixiPolygonDrawTool;
     /** @description 数值递增动画
      * @param params 动画参数
-     * @returns 设置为目标值并停止动画 */
+     * @returns 设置为目标值并停止动画
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDigitalIncreasingAnimation-递增动画
+     */
     LibPixiDigitalIncreasingAnimation: (params: import("./Utils/LibPixiDigitalIncreasingAnimation").LibPixiDigitalIncreasingAnimationParams) => () => void;
     /** @description 按下放大
-     * @param container 要放大的容器 */
+     * @param container 要放大的容器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDownScaleAnimation-按下放大
+     */
     LibPixiDownScaleAnimation: (container: import("pixi.js").Container) => void;
     /**
      * @description 将元素按照指定的列数和间隔排列成网格布局。
      * @param items 要排列的元素数组
      * @param gap 每个元素之间的间隔
-     * @param cols 网格的列数，默认为元素数量 */
+     * @param cols 网格的列数，默认为元素数量
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiGridLayout-网格布局
+     */
     LibPixiGridLayout: (items: import("pixi.js").Container[], gap: number, cols?: number) => void;
+    /**
+     * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
+     * @param items 要排列的元素数组。
+     * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
+     * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibArrangeLinear-间隔布局
+     */
+    LibArrangeLinear: (items: import("pixi.js").Container[], gap: number | number[], direction?: "x" | "y") => void;
 };

package/libPixiJs.js

@@ -36,120 +36,207 @@ import { LibPixiCircular } from "./Components/Base/LibPixiCircular";
 import { LibPixiDigitalIncreasingAnimation } from "./Utils/LibPixiDigitalIncreasingAnimation";
 import { LibPixiDownScaleAnimation } from "./Utils/LibPixiDownScaleAnimation";
 import { LibPixiGridLayout } from "./Utils/LibPixiGridLayout";
+import { LibArrangeLinear } from "./Utils/LibArrangeLinear";
 import { LibPixiSlide } from "./Components/Custom/LibPixiSlide";
 /** @description 组件 */
 export const Components = {
     Base: {
-        /** @description 自定义位图文本 */
+        /** @description 自定义位图文本
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiBitText-位图
+         */
         LibPixiBitText,
-        /** @description 自定义容器大小及背景色 */
+        /** @description 自定义容器大小及背景色
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiContainer-容器
+         */
         LibPixiContainer,
-        /** @description 利用贝塞尔曲线实现粒子移动 */
+        /** @description 利用贝塞尔曲线实现粒子移动
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiParticleMove-粒子容器
+         */
         LibPixiParticleMove,
-        /** @description 自定义矩形背景色 */
+        /** @description 自定义矩形背景色
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiRectBgColor-矩形
+         */
         LibPixiRectBgColor,
-        /** @description 矩形类，可用于一些场景的局部点击，传颜色是为了方便定位，最终可能需要将颜色隐藏掉 */
+        /** @description 矩形类，可用于一些场景的局部点击，传颜色是为了方便定位，最终可能需要将颜色隐藏掉
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiRectangle-矩形
+         */
         LibPixiRectangle,
-        /** @description 圆形 */
+        /** @description 圆形
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCircular-圆形
+         */
         LibPixiCircular,
-        /** @description 多边形类 */
+        /** @description 多边形类
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPolygon-多边形
+         */
         LibPixiPolygon,
-        /** @description 自定义 Spine 动画 */
+        /** @description 自定义 Spine 动画
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSpine-动画
+         */
         LibPixiSpine,
-        /** @description 自定义文本类 */
+        /** @description 自定义文本类
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiText-文本
+         */
         LibPixiText,
-        /** @description 自定义富文本类 */
+        /** @description 自定义富文本类
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiHtmlText-自定义富文本类
+         */
         LibPixiHtmlText,
     },
     Custom: {
-        /** @description 悬浮切换材质 */
+        /** @description 悬浮切换材质
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiButtonHover-按钮悬浮
+         */
         LibPixiButtonHover,
-        /** @description 右上角关闭按钮，支持悬浮旋转动画 */
+        /** @description 右上角关闭按钮，支持悬浮旋转动画
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCloseBtn-关闭按钮
+         */
         LibPixiCloseBtn,
-        /** @description 底部弹出抽屉 */
+        /** @description 底部弹出抽屉
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDrawer-抽屉
+         */
         LibPixiDrawer,
-        /** @description 监视帧率、Draw Call、Max Draw Call */
+        /** @description 监视帧率、Draw Call、Max Draw Call
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPerforMon-性能监视器
+         */
         LibPixiPerforMon,
-        /** @description 通过裁剪的方式显示进度条 */
+        /** @description 通过裁剪的方式显示进度条
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiProgress-进度条
+         */
         LibPixiProgress,
-        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹 */
+        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollContainerX-X轴滚动容器
+         */
         LibPixiScrollContainerX,
-        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹 */
+        /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollContainerY-Y轴滚动容器
+         */
         LibPixiScrollContainerY,
-        /** @description 通过鼠标或手指拖动数字列选择数字 */
+        /** @description 通过鼠标或手指拖动数字列选择数字
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollNum-数字滑动
+         */
         LibPixiScrollNum,
-        /** @description 类似轮播图，但是不会自动轮播 */
+        /** @description 类似轮播图，但是不会自动轮播
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlider-横向滑动图
+         */
         LibPixiSlider,
-        /** @description 滑动页 */
+        /** @description 滑动页
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlide-滑动页
+         */
         LibPixiSlide,
-        /** @description 最小、最大按钮和增减按钮功能及置灰逻辑 */
+        /** @description 最小、最大按钮和增减按钮功能及置灰逻辑
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSubAddMinMax-数字控制器
+         */
         LibPixiSubAddMinMax,
-        /** @description 绘制表格并填充数字 */
+        /** @description 绘制表格并填充数字
+         * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiTable-数字表格
+         */
         LibPixiTable,
     },
 };
 /** @description 方法 */
 export const Utils = {
-    /** @description 音频播放器 */
+    /** @description 音频播放器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiAudio-音频播放器
+     */
     LibPixiAudio,
-    /** @description 九宫格图 */
+    /** @description 九宫格图
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCreateNineGrid-九宫格图
+     */
     libPixiCreateNineGrid,
     /** @description 事件注册
      * @param v 事件容器
      * @param eventName 事件名称
      * @param callback 回调函数
-     * @param once 是否只执行一次 */
+     * @param once 是否只执行一次
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiEvent-事件注册
+     */
     libPixiEvent,
     /** @description 滤镜
      * @param filterName 滤镜名称
-     * @param v 滤镜值 */
+     * @param v 滤镜值
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiFilter-滤镜
+     */
     libPixiFilter,
     /** @description 间隔触发
      * @param callback 回调函数
-     * @param interval 间隔毫秒，或随机范围 */
+     * @param interval 间隔毫秒，或随机范围
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiIntervalTrigger-间隔触发
+     */
     libPixiIntervalTrigger,
     /** @description 点击容器外或入口按钮时隐藏
      * @param container 容器
      * @param btn 按钮
-     * @param onClose 关闭回调 */
+     * @param onClose 关闭回调
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiOutsideClick-失焦隐藏
+     */
     libPixiOutsideClick,
     /** @description 为容器创建并应用一个矩形遮罩，用于隐藏溢出的内容，函数会返回遮罩，可控制是否显示遮罩
-     * @param container 需要设置遮罩裁剪的容器 */
+     * @param container 需要设置遮罩裁剪的容器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiOverflowHidden-溢出裁剪
+     */
     libPixiOverflowHidden,
     /** @description 基于 Ticker 和 Promise 的定时器
      * @param delay 延迟时间
-     * @param callback 延迟后执行的函数 */
+     * @param callback 延迟后执行的函数
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPromiseTickerTimeout-TickerPromise定时器
+     */
     libPixiPromiseTickerTimeout,
     /** @description 元素超过指定宽度就缩放
      * @param scaleContainer 需要缩放的元素
      * @param maxWidth 最大宽度
-     * @param maxHeight 最大高度 */
+     * @param maxHeight 最大高度
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScaleContainer-超出缩放
+     */
     libPixiScaleContainer,
     /** @description 阴影
      * @param container 需要添加阴影的元素
-     * @param config 配置项 */
+     * @param config 配置项
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiShadow-阴影
+     */
     libPixiShadow,
     /** @description 基于 Ticker 的定时器
      * @param callback 延迟后执行的函数
-     * @param delay 延迟时间 */
+     * @param delay 延迟时间
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiTickerTimeout-Ticker定时器
+     */
     libPixiTickerTimeout,
-    /** @description 滑动选择器核心代码 */
+    /** @description 滑动选择器核心代码
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlideInput-滑动选择值
+     */
     LibPixiSlideInput,
-    /** @description 事件总线更新实例汇总 */
+    /** @description 事件总线更新实例汇总
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibGlobalUpdater-事件实例汇总
+     */
     LibPixiGlobalUpdater,
-    /** @description 多边形绘制工具，绘制时浏览器窗口需要全屏显示，空格键控制开始和结束，开始后鼠标进行点击绘制，退格删除点，空格结束绘制，绘制结果在控制台打印，不满意可再次按空格清空并重新绘制 */
+    /** @description 多边形绘制工具，绘制时浏览器窗口需要全屏显示，空格键控制开始和结束，开始后鼠标进行点击绘制，退格删除点，空格结束绘制，绘制结果在控制台打印，不满意可再次按空格清空并重新绘制
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPolygonDrawTool-多边形绘制
+     */
     LibPixiPolygonDrawTool,
     /** @description 数值递增动画
      * @param params 动画参数
-     * @returns 设置为目标值并停止动画 */
+     * @returns 设置为目标值并停止动画
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDigitalIncreasingAnimation-递增动画
+     */
     LibPixiDigitalIncreasingAnimation,
     /** @description 按下放大
-     * @param container 要放大的容器 */
+     * @param container 要放大的容器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDownScaleAnimation-按下放大
+     */
     LibPixiDownScaleAnimation,
     /**
      * @description 将元素按照指定的列数和间隔排列成网格布局。
      * @param items 要排列的元素数组
      * @param gap 每个元素之间的间隔
-     * @param cols 网格的列数，默认为元素数量 */
+     * @param cols 网格的列数，默认为元素数量
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiGridLayout-网格布局
+     */
     LibPixiGridLayout,
+    /**
+     * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
+     * @param items 要排列的元素数组。
+     * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
+     * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibArrangeLinear-间隔布局
+     */
+    LibArrangeLinear,
 };

package/lyb-pixi.js

@@ -1315,7 +1315,7 @@
       var ys = arrObjKeys(obj, inspect2);
       var isPlainObject = gPO ? gPO(obj) === Object.prototype : obj instanceof Object || obj.constructor === Object;
       var protoTag = obj instanceof Object ? "" : "null prototype";
-      var stringTag = !isPlainObject && toStringTag && Object(obj) === obj && toStringTag in obj ? $slice.call(toStr$1(obj), 8, -1) : protoTag ? "Object" : "";
+      var stringTag = !isPlainObject && toStringTag && Object(obj) === obj && toStringTag in obj ? $slice.call(toStr(obj), 8, -1) : protoTag ? "Object" : "";
       var constructorTag = isPlainObject || typeof obj.constructor !== "function" ? "" : obj.constructor.name ? obj.constructor.name + " " : "";
       var tag = constructorTag + (stringTag || protoTag ? "[" + $join.call($concat$1.call([], stringTag || [], protoTag || []), ": ") + "] " : "");
       if (ys.length === 0) {
@@ -1337,25 +1337,25 @@
     return $replace$1.call(String(s2), /"/g, """);
   }
   function isArray$3(obj) {
-    return toStr$1(obj) === "[object Array]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object Array]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isDate(obj) {
-    return toStr$1(obj) === "[object Date]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object Date]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isRegExp$1(obj) {
-    return toStr$1(obj) === "[object RegExp]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object RegExp]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isError(obj) {
-    return toStr$1(obj) === "[object Error]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object Error]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isString(obj) {
-    return toStr$1(obj) === "[object String]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object String]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isNumber(obj) {
-    return toStr$1(obj) === "[object Number]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object Number]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isBoolean(obj) {
-    return toStr$1(obj) === "[object Boolean]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
+    return toStr(obj) === "[object Boolean]" && (!toStringTag || !(typeof obj === "object" && toStringTag in obj));
   }
   function isSymbol(obj) {
     if (hasShammedSymbols) {
@@ -1391,7 +1391,7 @@
   function has$3(obj, key) {
     return hasOwn$1.call(obj, key);
   }
-  function toStr$1(obj) {
+  function toStr(obj) {
     return objectToString.call(obj);
   }
   function nameOf(f2) {
@@ -1700,7 +1700,7 @@
   var uri = URIError;
   var abs$1 = Math.abs;
   var floor$1 = Math.floor;
-  var max$2 = Math.max;
+  var max$1 = Math.max;
   var min$1 = Math.min;
   var pow$1 = Math.pow;
   var round$2 = Math.round;
@@ -1833,78 +1833,102 @@
     Object_getPrototypeOf = $Object2.getPrototypeOf || null;
     return Object_getPrototypeOf;
   }
-  var ERROR_MESSAGE = "Function.prototype.bind called on incompatible ";
-  var toStr = Object.prototype.toString;
-  var max$1 = Math.max;
-  var funcType = "[object Function]";
-  var concatty = function concatty2(a2, b2) {
-    var arr = [];
-    for (var i2 = 0; i2 < a2.length; i2 += 1) {
-      arr[i2] = a2[i2];
-    }
-    for (var j2 = 0; j2 < b2.length; j2 += 1) {
-      arr[j2 + a2.length] = b2[j2];
-    }
-    return arr;
-  };
-  var slicy = function slicy2(arrLike, offset) {
-    var arr = [];
-    for (var i2 = offset || 0, j2 = 0; i2 < arrLike.length; i2 += 1, j2 += 1) {
-      arr[j2] = arrLike[i2];
-    }
-    return arr;
-  };
-  var joiny = function(arr, joiner) {
-    var str = "";
-    for (var i2 = 0; i2 < arr.length; i2 += 1) {
-      str += arr[i2];
-      if (i2 + 1 < arr.length) {
-        str += joiner;
+  var implementation;
+  var hasRequiredImplementation;
+  function requireImplementation() {
+    if (hasRequiredImplementation)
+      return implementation;
+    hasRequiredImplementation = 1;
+    var ERROR_MESSAGE = "Function.prototype.bind called on incompatible ";
+    var toStr2 = Object.prototype.toString;
+    var max2 = Math.max;
+    var funcType = "[object Function]";
+    var concatty = function concatty2(a2, b2) {
+      var arr = [];
+      for (var i2 = 0; i2 < a2.length; i2 += 1) {
+        arr[i2] = a2[i2];
       }
-    }
-    return str;
-  };
-  var implementation$1 = function bind2(that) {
-    var target = this;
-    if (typeof target !== "function" || toStr.apply(target) !== funcType) {
-      throw new TypeError(ERROR_MESSAGE + target);
-    }
-    var args = slicy(arguments, 1);
-    var bound;
-    var binder = function() {
-      if (this instanceof bound) {
-        var result = target.apply(
-          this,
-          concatty(args, arguments)
-        );
-        if (Object(result) === result) {
-          return result;
+      for (var j2 = 0; j2 < b2.length; j2 += 1) {
+        arr[j2 + a2.length] = b2[j2];
+      }
+      return arr;
+    };
+    var slicy = function slicy2(arrLike, offset) {
+      var arr = [];
+      for (var i2 = offset || 0, j2 = 0; i2 < arrLike.length; i2 += 1, j2 += 1) {
+        arr[j2] = arrLike[i2];
+      }
+      return arr;
+    };
+    var joiny = function(arr, joiner) {
+      var str = "";
+      for (var i2 = 0; i2 < arr.length; i2 += 1) {
+        str += arr[i2];
+        if (i2 + 1 < arr.length) {
+          str += joiner;
         }
-        return this;
       }
-      return target.apply(
-        that,
-        concatty(args, arguments)
-      );
+      return str;
     };
-    var boundLength = max$1(0, target.length - args.length);
-    var boundArgs = [];
-    for (var i2 = 0; i2 < boundLength; i2++) {
-      boundArgs[i2] = "$" + i2;
-    }
-    bound = Function("binder", "return function (" + joiny(boundArgs, ",") + "){ return binder.apply(this,arguments); }")(binder);
-    if (target.prototype) {
-      var Empty = function Empty2() {
+    implementation = function bind2(that) {
+      var target = this;
+      if (typeof target !== "function" || toStr2.apply(target) !== funcType) {
+        throw new TypeError(ERROR_MESSAGE + target);
+      }
+      var args = slicy(arguments, 1);
+      var bound;
+      var binder = function() {
+        if (this instanceof bound) {
+          var result = target.apply(
+            this,
+            concatty(args, arguments)
+          );
+          if (Object(result) === result) {
+            return result;
+          }
+          return this;
+        }
+        return target.apply(
+          that,
+          concatty(args, arguments)
+        );
       };
-      Empty.prototype = target.prototype;
-      bound.prototype = new Empty();
-      Empty.prototype = null;
-    }
-    return bound;
-  };
-  var implementation = implementation$1;
-  var functionBind = Function.prototype.bind || implementation;
-  var functionCall = Function.prototype.call;
+      var boundLength = max2(0, target.length - args.length);
+      var boundArgs = [];
+      for (var i2 = 0; i2 < boundLength; i2++) {
+        boundArgs[i2] = "$" + i2;
+      }
+      bound = Function("binder", "return function (" + joiny(boundArgs, ",") + "){ return binder.apply(this,arguments); }")(binder);
+      if (target.prototype) {
+        var Empty = function Empty2() {
+        };
+        Empty.prototype = target.prototype;
+        bound.prototype = new Empty();
+        Empty.prototype = null;
+      }
+      return bound;
+    };
+    return implementation;
+  }
+  var functionBind;
+  var hasRequiredFunctionBind;
+  function requireFunctionBind() {
+    if (hasRequiredFunctionBind)
+      return functionBind;
+    hasRequiredFunctionBind = 1;
+    var implementation2 = requireImplementation();
+    functionBind = Function.prototype.bind || implementation2;
+    return functionBind;
+  }
+  var functionCall;
+  var hasRequiredFunctionCall;
+  function requireFunctionCall() {
+    if (hasRequiredFunctionCall)
+      return functionCall;
+    hasRequiredFunctionCall = 1;
+    functionCall = Function.prototype.call;
+    return functionCall;
+  }
   var functionApply;
   var hasRequiredFunctionApply;
   function requireFunctionApply() {
@@ -1915,14 +1939,14 @@
     return functionApply;
   }
   var reflectApply = typeof Reflect !== "undefined" && Reflect && Reflect.apply;
-  var bind$2 = functionBind;
+  var bind$2 = requireFunctionBind();
   var $apply$1 = requireFunctionApply();
-  var $call$2 = functionCall;
+  var $call$2 = requireFunctionCall();
   var $reflectApply = reflectApply;
   var actualApply = $reflectApply || bind$2.call($call$2, $apply$1);
-  var bind$1 = functionBind;
+  var bind$1 = requireFunctionBind();
   var $TypeError$4 = type;
-  var $call$1 = functionCall;
+  var $call$1 = requireFunctionCall();
   var $actualApply = actualApply;
   var callBindApplyHelpers = function callBindBasic2(args) {
     if (args.length < 1 || typeof args[0] !== "function") {
@@ -1991,7 +2015,7 @@
     hasRequiredHasown = 1;
     var call = Function.prototype.call;
     var $hasOwn = Object.prototype.hasOwnProperty;
-    var bind2 = functionBind;
+    var bind2 = requireFunctionBind();
     hasown = bind2.call(call, $hasOwn);
     return hasown;
   }
@@ -2006,7 +2030,7 @@
   var $URIError = uri;
   var abs = abs$1;
   var floor = floor$1;
-  var max = max$2;
+  var max = max$1;
   var min = min$1;
   var pow = pow$1;
   var round$1 = round$2;
@@ -2040,7 +2064,7 @@
   var $ObjectGPO = requireObject_getPrototypeOf();
   var $ReflectGPO = requireReflect_getPrototypeOf();
   var $apply = requireFunctionApply();
-  var $call = functionCall;
+  var $call = requireFunctionCall();
   var needsEval = {};
   var TypedArray = typeof Uint8Array === "undefined" || !getProto ? undefined$1 : getProto(Uint8Array);
   var INTRINSICS = {
@@ -2210,7 +2234,7 @@
     "%WeakMapPrototype%": ["WeakMap", "prototype"],
     "%WeakSetPrototype%": ["WeakSet", "prototype"]
   };
-  var bind = functionBind;
+  var bind = requireFunctionBind();
   var hasOwn = requireHasown();
   var $concat = bind.call($call, Array.prototype.concat);
   var $spliceApply = bind.call($apply, Array.prototype.splice);
@@ -55100,6 +55124,25 @@ void main(void){
       }
     });
   };
+  const LibArrangeLinear = (items, gap, direction = "x") => {
+    if (Array.isArray(gap)) {
+      if (gap.length !== items.length - 1) {
+        console.error(new Error("间隔的数组长度只能等于元素数组长度-1"));
+        return;
+      }
+    }
+    let lastPosition = 0;
+    items.forEach((item, index) => {
+      const position = index === 0 ? 0 : lastPosition + (Array.isArray(gap) ? gap[index - 1] : gap);
+      if (direction === "x") {
+        item.x = position;
+        lastPosition = item.x + item.width;
+      } else {
+        item.y = position;
+        lastPosition = item.y + item.height;
+      }
+    });
+  };
   class LibPixiSlide extends LibPixiContainer {
     constructor(params) {
       const {
@@ -55335,117 +55378,203 @@ void main(void){
   }
   const Components = {
     Base: {
-      /** @description 自定义位图文本 */
+      /** @description 自定义位图文本
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiBitText-位图
+       */
       LibPixiBitText,
-      /** @description 自定义容器大小及背景色 */
+      /** @description 自定义容器大小及背景色
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiContainer-容器
+       */
       LibPixiContainer,
-      /** @description 利用贝塞尔曲线实现粒子移动 */
+      /** @description 利用贝塞尔曲线实现粒子移动
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiParticleMove-粒子容器
+       */
       LibPixiParticleMove,
-      /** @description 自定义矩形背景色 */
+      /** @description 自定义矩形背景色
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiRectBgColor-矩形
+       */
       LibPixiRectBgColor,
-      /** @description 矩形类，可用于一些场景的局部点击，传颜色是为了方便定位，最终可能需要将颜色隐藏掉 */
+      /** @description 矩形类，可用于一些场景的局部点击，传颜色是为了方便定位，最终可能需要将颜色隐藏掉
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiRectangle-矩形
+       */
       LibPixiRectangle,
-      /** @description 圆形 */
+      /** @description 圆形
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCircular-圆形
+       */
       LibPixiCircular,
-      /** @description 多边形类 */
+      /** @description 多边形类
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPolygon-多边形
+       */
       LibPixiPolygon,
-      /** @description 自定义 Spine 动画 */
+      /** @description 自定义 Spine 动画
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSpine-动画
+       */
       LibPixiSpine,
-      /** @description 自定义文本类 */
+      /** @description 自定义文本类
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiText-文本
+       */
       LibPixiText,
-      /** @description 自定义富文本类 */
+      /** @description 自定义富文本类
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiHtmlText-自定义富文本类
+       */
       LibPixiHtmlText
     },
     Custom: {
-      /** @description 悬浮切换材质 */
+      /** @description 悬浮切换材质
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiButtonHover-按钮悬浮
+       */
       LibPixiButtonHover,
-      /** @description 右上角关闭按钮，支持悬浮旋转动画 */
+      /** @description 右上角关闭按钮，支持悬浮旋转动画
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCloseBtn-关闭按钮
+       */
       LibPixiCloseBtn,
-      /** @description 底部弹出抽屉 */
+      /** @description 底部弹出抽屉
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDrawer-抽屉
+       */
       LibPixiDrawer,
-      /** @description 监视帧率、Draw Call、Max Draw Call */
+      /** @description 监视帧率、Draw Call、Max Draw Call
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPerforMon-性能监视器
+       */
       LibPixiPerforMon,
-      /** @description 通过裁剪的方式显示进度条 */
+      /** @description 通过裁剪的方式显示进度条
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiProgress-进度条
+       */
       LibPixiProgress,
-      /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹 */
+      /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollContainerX-X轴滚动容器
+       */
       LibPixiScrollContainerX,
-      /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹 */
+      /** @description 支持鼠标滚轮滚动、鼠标拖动、手指滑动，支持惯性滚动及回弹
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollContainerY-Y轴滚动容器
+       */
       LibPixiScrollContainerY,
-      /** @description 通过鼠标或手指拖动数字列选择数字 */
+      /** @description 通过鼠标或手指拖动数字列选择数字
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScrollNum-数字滑动
+       */
       LibPixiScrollNum,
-      /** @description 类似轮播图，但是不会自动轮播 */
+      /** @description 类似轮播图，但是不会自动轮播
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlider-横向滑动图
+       */
       LibPixiSlider,
-      /** @description 滑动页 */
+      /** @description 滑动页
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlide-滑动页
+       */
       LibPixiSlide,
-      /** @description 最小、最大按钮和增减按钮功能及置灰逻辑 */
+      /** @description 最小、最大按钮和增减按钮功能及置灰逻辑
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSubAddMinMax-数字控制器
+       */
       LibPixiSubAddMinMax,
-      /** @description 绘制表格并填充数字 */
+      /** @description 绘制表格并填充数字
+       * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiTable-数字表格
+       */
       LibPixiTable
     }
   };
   const Utils = {
-    /** @description 音频播放器 */
+    /** @description 音频播放器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiAudio-音频播放器
+     */
     LibPixiAudio,
-    /** @description 九宫格图 */
+    /** @description 九宫格图
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiCreateNineGrid-九宫格图
+     */
     libPixiCreateNineGrid,
     /** @description 事件注册
      * @param v 事件容器
      * @param eventName 事件名称
      * @param callback 回调函数
-     * @param once 是否只执行一次 */
+     * @param once 是否只执行一次
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiEvent-事件注册
+     */
     libPixiEvent,
     /** @description 滤镜
      * @param filterName 滤镜名称
-     * @param v 滤镜值 */
+     * @param v 滤镜值
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiFilter-滤镜
+     */
     libPixiFilter,
     /** @description 间隔触发
      * @param callback 回调函数
-     * @param interval 间隔毫秒，或随机范围 */
+     * @param interval 间隔毫秒，或随机范围
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiIntervalTrigger-间隔触发
+     */
     libPixiIntervalTrigger,
     /** @description 点击容器外或入口按钮时隐藏
      * @param container 容器
      * @param btn 按钮
-     * @param onClose 关闭回调 */
+     * @param onClose 关闭回调
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiOutsideClick-失焦隐藏
+     */
     libPixiOutsideClick,
     /** @description 为容器创建并应用一个矩形遮罩，用于隐藏溢出的内容，函数会返回遮罩，可控制是否显示遮罩
-     * @param container 需要设置遮罩裁剪的容器 */
+     * @param container 需要设置遮罩裁剪的容器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiOverflowHidden-溢出裁剪
+     */
     libPixiOverflowHidden,
     /** @description 基于 Ticker 和 Promise 的定时器
      * @param delay 延迟时间
-     * @param callback 延迟后执行的函数 */
+     * @param callback 延迟后执行的函数
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPromiseTickerTimeout-TickerPromise定时器
+     */
     libPixiPromiseTickerTimeout,
     /** @description 元素超过指定宽度就缩放
      * @param scaleContainer 需要缩放的元素
      * @param maxWidth 最大宽度
-     * @param maxHeight 最大高度 */
+     * @param maxHeight 最大高度
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiScaleContainer-超出缩放
+     */
     libPixiScaleContainer,
     /** @description 阴影
      * @param container 需要添加阴影的元素
-     * @param config 配置项 */
+     * @param config 配置项
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiShadow-阴影
+     */
     libPixiShadow,
     /** @description 基于 Ticker 的定时器
      * @param callback 延迟后执行的函数
-     * @param delay 延迟时间 */
+     * @param delay 延迟时间
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiTickerTimeout-Ticker定时器
+     */
     libPixiTickerTimeout,
-    /** @description 滑动选择器核心代码 */
+    /** @description 滑动选择器核心代码
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiSlideInput-滑动选择值
+     */
     LibPixiSlideInput,
-    /** @description 事件总线更新实例汇总 */
+    /** @description 事件总线更新实例汇总
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibGlobalUpdater-事件实例汇总
+     */
     LibPixiGlobalUpdater,
-    /** @description 多边形绘制工具，绘制时浏览器窗口需要全屏显示，空格键控制开始和结束，开始后鼠标进行点击绘制，退格删除点，空格结束绘制，绘制结果在控制台打印，不满意可再次按空格清空并重新绘制 */
+    /** @description 多边形绘制工具，绘制时浏览器窗口需要全屏显示，空格键控制开始和结束，开始后鼠标进行点击绘制，退格删除点，空格结束绘制，绘制结果在控制台打印，不满意可再次按空格清空并重新绘制
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiPolygonDrawTool-多边形绘制
+     */
     LibPixiPolygonDrawTool,
     /** @description 数值递增动画
      * @param params 动画参数
-     * @returns 设置为目标值并停止动画 */
+     * @returns 设置为目标值并停止动画
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDigitalIncreasingAnimation-递增动画
+     */
     LibPixiDigitalIncreasingAnimation,
     /** @description 按下放大
-     * @param container 要放大的容器 */
+     * @param container 要放大的容器
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiDownScaleAnimation-按下放大
+     */
     LibPixiDownScaleAnimation,
     /**
      * @description 将元素按照指定的列数和间隔排列成网格布局。
      * @param items 要排列的元素数组
      * @param gap 每个元素之间的间隔
-     * @param cols 网格的列数，默认为元素数量 */
-    LibPixiGridLayout
+     * @param cols 网格的列数，默认为元素数量
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibPixiGridLayout-网格布局
+     */
+    LibPixiGridLayout,
+    /**
+     * @description 按照指定方向（水平或垂直）排列元素，支持固定间隔或自定义每个间隔。
+     * @param items 要排列的元素数组。
+     * @param gap 元素之间的间隔，可以是固定间隔或自定义的间隔数组。
+     * @param direction 排列方向，"x"表示水平，"y"表示垂直，默认为水平。
+     * @link 使用方法：https://www.npmjs.com/package/lyb-pixi-js#LibArrangeLinear-间隔布局
+     */
+    LibArrangeLinear
   };
   const LibPixiJs = /* @__PURE__ */ Object.freeze(/* @__PURE__ */ Object.defineProperty({
     __proto__: null,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lyb-pixi-js",
-  "version": "1.9.6",
+  "version": "1.9.7",
   "description": "自用Pixi.JS方法库",
   "license": "ISC",
   "exports": {