enr 0.2.3-alpha.2

package/customHooks/useRipples/buildBackground/run-side.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/run-side.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * 设置缓变
+ *
+ * 缓变分两种，一种是没有任何设置的缓变；另一种就是两个不同类型之间的缓变
+ *
+ *
+ */
+export declare function runSide(this: Ripples): void;

package/customHooks/useRipples/buildBackground/type.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/type.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  原使用的样式  */
+export type OriginStyle = {
+    /**  原始使用行内背景样式  */
+    inlineBackground: string;
+    /** 原始使用的行内背景色   */
+    inlineBackgroundColor: string;
+    /**  原始使用的背景图的样式  */
+    inlineBackgroundImage: string;
+    /**  元素的位置  */
+    position: string;
+    /**  元素的背景色  */
+    backgroundColor: string;
+    /**  元素的背景图  */
+    backgroundImage: string;
+    /**  元素的背景图的尺寸（多背景下）  */
+    backgroundSize: string;
+    /**  元素的背景图的位置  */
+    backgroundPosition: string;
+    /**  元素的背景图的重复方式  */
+    backgroundRepeat: string;
+    /**  元素的背景图的剪切方式  */
+    backgroundClip: string;
+    /**  元素的背景图的起点  */
+    backgroundOrigin: string;
+    /**  元素的背景图相对视口的滚动方式  */
+    backgroundAttachment: string;
+    /**  当前的宽  */
+    width: number;
+    /**  当前的高  */
+    height: number;
+};

package/customHooks/useRipples/buildBackground/utils/bind-image.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/utils/bind-image.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../../ripplesClass';
+import { DrawImage } from '../../rippersData/fadeData';
+/**  绑定图片  */
+export declare function bindImage(this: Ripples, textImageSource: DrawImage): void;

package/customHooks/useRipples/buildBackground/utils/create-canvas-element.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/utils/create-canvas-element.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../../../../components/ripples';
+/**  根据给出的 html 数据构建一个 canvas   */
+export declare function createCanvasElement(this: Ripples, img: CanvasImageSource): HTMLCanvasElement;

package/customHooks/useRipples/buildBackground/utils/create-image-by-src.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/utils/create-image-by-src.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  根据给出的 src 获取一个 img 对象  */
+export declare function createImageBySrc(src: string, width: number, height: number): HTMLImageElement;

package/customHooks/useRipples/buildBackground/utils/get-background-style.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/utils/get-background-style.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { OriginStyle } from '../type';
+/**  获取元素的样式  */
+export declare function getBackgroundStyles(element: HTMLElement): OriginStyle;

package/customHooks/useRipples/buildBackground/utils/hide-css-background.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/utils/hide-css-background.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../../ripplesClass';
+/**
+ * ## 隐藏背景
+ *
+ * 触发于
+ * - 手动恢复背景 webGl 的显示
+ * - 初始化时隐藏
+ * - 父级样式属性发生变更的时候
+ */
+export declare function hideCssBackground(this: Ripples): void;

package/customHooks/useRipples/buildBackground/utils/restore-css-background.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/utils/restore-css-background.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../../ripplesClass';
+/**
+ * 恢复背景样式
+ *
+ * 在使用过程中，可能会切换 webGL 的显隐状态，而手动处理背景的更替
+ */
+export declare function restoreCssBackground(this: Ripples): void;

package/customHooks/useRipples/callback/can-side.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/can-side.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *  是否能执行渐变
+ *
+ * 返回值为 true 时禁止渐变
+ *
+ */
+export declare function forbiddenRunSide(this: Ripples): boolean;

package/customHooks/useRipples/callback/destroy.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/destroy.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**  注销  */
+export declare function destroy(this: Ripples): void;

package/customHooks/useRipples/callback/drop.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/drop.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**  触发滴落效果  */
+export declare function drop(this: Ripples, x: number, y: number, radius: number, strength: number): void;

package/customHooks/useRipples/callback/extract-url.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/extract-url.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/** 检测数据是否为 url 外联图像地址 */
+export declare function extractUrl(value: string): string | null;

package/customHooks/useRipples/callback/fade.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/fade.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**  两个图像间的淡入淡出  */
+export declare function fade(this: Ripples): any;

package/customHooks/useRipples/callback/get-new-image.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/get-new-image.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { OriginStyle } from '../buildBackground/type';
+import { UseOptions } from '../rippersData/useOptions';
+/**  获取当前的背景图的地址  */
+export declare function getNewImage(options: UseOptions, lastStyle: OriginStyle): string | null;
+/**  获取新的背景图  */
+export declare function getNewColor(options: UseOptions, originStyle: OriginStyle): string;
+/**  获取新的渐变  */
+export declare function getNewGradient(): void;

package/customHooks/useRipples/callback/reload-background.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/reload-background.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * 重新加载背景图片
+ *
+ */
+export declare function reloadBackground(this: Ripples): void;

package/customHooks/useRipples/callback/scale.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/callback/scale.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  缩放效果 （暂未用到） */
+export declare function scale(): void;

package/customHooks/useRipples/index.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RefObject } from 'react';
+import { BackgroundRipplesProps, RippleImgUrl, RipplesOptions } from './types';
+import { Ripples } from './ripplesClass';
+/**
+ *
+ * ## 使用绘制 ripples 上一层
+ *
+ *
+ * @param canvas `usrRef` 包裹的 `HTMLCanvasElement`，用于绘制图像
+ * @param option  初始化的
+ * @version 0.0.3
+ * @see  https://earthnut.dev/custom-hooks/use-ripples
+ * @see  JQuery https://github.com/sirxemic/jquery.ripples
+ * @example
+ *
+ * 下面是在 <BackgroundRipple> 中使用
+ *
+ * ```ts
+ * import { useRipples } from 'earthnut';
+ *
+ *  export function BackgroundRipple(props: BackgroundRipplesProps) {
+ *
+ *   // canvas 元素
+ *  const canvas = useRef<HTMLCanvasElement>(null);
+ *
+ *  // 使用 ripples
+ *  const ripplesRef = useRipples(canvas, props);
+ *
+ *  return (<>
+ *     <canvas ref={canvas}></canvas>
+ *     {props.children}
+ *  </>);
+ *  }
+ *
+ * ```
+ *
+ */
+export declare function useRipples(canvas: RefObject<HTMLCanvasElement | null>, option?: RipplesOptions): RefObject<Ripples | null>;
+export type { Ripples, BackgroundRipplesProps, RipplesOptions, RippleImgUrl };

package/customHooks/useRipples/init/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/init/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * 初始化 webGL
+ */
+export declare function initGL(this: Ripples): void;

package/customHooks/useRipples/init/initEvent.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/init/initEvent.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * 初始化事件
+ */
+export declare function setupPointerEvents(this: Ripples): void;

package/customHooks/useRipples/init/initShaders.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/init/initShaders.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *
+ * 初始化着色器
+ *
+ */
+export declare function initShaders(this: Ripples): void;

package/customHooks/useRipples/init/initTexture.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/init/initTexture.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *
+ * 初始化纹理
+ *
+ */
+export declare function initTexture(this: Ripples): void;

package/customHooks/useRipples/render/computeTextureBoundaries.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/computeTextureBoundaries.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**  计算纹理边界及背景图  */
+export declare function computeTextureBoundaries(this: Ripples): void;

package/customHooks/useRipples/render/draw.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/draw.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *
+ * 绘制
+ *
+ */
+export declare function draw(this: Ripples): void;

package/customHooks/useRipples/render/drawQuad.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/drawQuad.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *
+ * 绘制 GL 数据流
+ *
+ */
+export declare function drawQuad(this: Ripples): void;

package/customHooks/useRipples/render/dropAtPointer.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/dropAtPointer.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *
+ * 触发的点
+ *
+ */
+export declare function dropAtPointer(this: Ripples, pointer: MouseEvent | Touch, radius: number, strength: number): void;

package/customHooks/useRipples/render/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * 开启绘制
+ *
+ */
+export declare function render(this: Ripples): void;

package/customHooks/useRipples/render/swapBufferIndices.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/swapBufferIndices.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * swap 缓冲区索引
+ */
+export declare function swapBufferIndices(this: Ripples): void;

package/customHooks/useRipples/render/update.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/render/update.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ * 更新
+ */
+export declare function update(this: Ripples): void;

package/customHooks/useRipples/rippersData/defaultData.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/rippersData/defaultData.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RipplesDefaultData } from '../types';
+/**
+ * 默认值
+ */
+export declare const defaultData: RipplesDefaultData;

package/customHooks/useRipples/rippersData/fadeData.d.ts

@@ -0,0 +1,51 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/rippersData/fadeData.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+export type DrawImage = {
+    /**  资源  */
+    resource: HTMLCanvasElement | HTMLImageElement;
+    /**  类型  */
+    kind: 'image' | 'linear-gradient' | 'background-color' | 'default' | 'mix';
+    /**  标识  */
+    tag: string;
+    /**  当前的宽  */
+    width: number;
+    /**  当前的高  */
+    height: number;
+};
+/**  背景渐变的数据  */
+export declare class FadeData {
+    #private;
+    /**  背景页面的数据  */
+    backgroundInfo: {
+        width: number;
+        height: number;
+    };
+    /**  缺省背景图时的 id  */
+    transparentId: NodeJS.Timeout;
+    /**  最后使用
+     *
+     * 如果没有 toBeList 为空值，则当前渲染的为此纹理）绘制的图像
+     */
+    lastDrawImage: DrawImage;
+    /**  当前绘制的图像
+     *
+     * 该值仅出现在需要渐变过程中，一旦渐变完成，实际渲染的值就成了最后渲染的值
+     */
+    toBeList: DrawImage[];
+    /**  绘制进度  */
+    drawProgress: number;
+    /**  是否处于绘制过渡状态  */
+    isTransitioning: boolean;
+    isDark: boolean;
+    /**  执行渐变  */
+    run(): void;
+    /**  销毁  */
+    destroy(): void;
+    /**  创建背景渐变的数据  */
+    constructor(_Ripples: Ripples);
+}

package/customHooks/useRipples/rippersData/index.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/rippersData/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/****************************************************************************
+ * @Author earthnut
+ * @Email earthnut.dev@outlook.com
+ * @ProjectName website
+ * @FileName dataStore.ts
+ * @CreateDate  周六  12/07/2024
+ * @Description 数据库
+ ****************************************************************************/
+/**
+ * Ripple 使用的数据，Ripple 继承该类
+ */
+export declare class RipplesData {
+    /**
+     * canvas 元素
+     */
+    canvas: HTMLCanvasElement;
+    /**
+     * WebGL 绘图上下文
+     */
+    gl: WebGLRenderingContext;
+    /**
+     * 配置
+     */
+    config: {
+        type: number;
+        linearSupport: boolean;
+        extensions: string[];
+        arrayType: Float32ArrayConstructor | null;
+    } | null;
+    /**
+     * 初始化情况
+     */
+    initState: boolean;
+    /**
+     * 构造方法
+     *
+     * @param canvas  传入 canvas 元素来初始化必要的数据
+     */
+    constructor(canvas: HTMLCanvasElement);
+}

package/customHooks/useRipples/rippersData/loadConfig.d.ts

@@ -0,0 +1,25 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/rippersData/loadConfig.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/****************************************************************************
+ * @Author earthnut
+ * @Email earthnut.dev@outlook.com
+ * @ProjectName website
+ * @FileName loadConfig.ts
+ * @CreateDate  周五  12/13/2024
+ * @Description 加载 config
+ ****************************************************************************/
+import { RipplesData } from './index';
+/**
+ * 执行的配置数据
+ *
+ */
+export declare function loadConfig(this: RipplesData): {
+    type: number;
+    linearSupport: boolean;
+    arrayType: Float32ArrayConstructor | null;
+    extensions: string[];
+} | null;

package/customHooks/useRipples/rippersData/renderData.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/rippersData/renderData.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { OriginStyle } from '../buildBackground/type';
+import { Ripples } from '../ripplesClass';
+import { Program, Textures } from '../types';
+/**
+ *
+ * 原始数据类
+ *
+ * 记录了除参数数据外的运行数据
+ *
+ */
+export declare class RipplesRenderData {
+    /**  渲染数据流
+     *
+     * 该值在 init 中进行初始化
+     */
+    quad: WebGLBuffer;
+    /**
+     * 上一次雨滴滴落的时间
+     *
+     * 该时间更新触发时机：
+     * - 2.2s 内没有事件触发
+     * - 鼠标交互更新
+     */
+    lastRaindropsFallTime: number;
+    /**  canvas 父级元素 该值在主 class 中初始化 */
+    parentElement: HTMLElement;
+    /**  父级元素的属性变化监听者  */
+    mutationObserver: null | MutationObserver;
+    /**  父级尺寸变化监听者  */
+    resizeObserver: null | ResizeObserver;
+    /**  渲染程序  */
+    renderProgram: Program;
+    /**  图像资源的配置  */
+    imageSource: string;
+    /**  该值于初始化着色器时初始化  */
+    dropProgram: Program;
+    /**  更新流  */
+    updateProgram: Program;
+    /**  纹理  */
+    textures: Textures;
+    /**  背景纹理  */
+    backgroundTexture: WebGLTexture;
+    /**  纹理数据  */
+    textureDelta: Float32Array<ArrayBuffer>;
+    /**    */
+    framebuffers: WebGLFramebuffer[];
+    /**    */
+    bufferWriteIndex: number;
+    /**    */
+    bufferReadIndex: number;
+    /**  最原始的样式  */
+    originStyle: OriginStyle;
+    /**  上一次使用的样式  */
+    lastUseStyle: OriginStyle;
+    /** 事件  */
+    events: {
+        mousemove: (e: MouseEvent) => void;
+        mousedown: (e: MouseEvent) => void;
+        touchmove: (e: TouchEvent) => void;
+        touchstart: (e: TouchEvent) => void;
+    };
+    /**  渲染 id  */
+    animationFrameId: number;
+    /**
+     * 构建 Ripple 的渲染数据
+     *
+     * @param canvas 使用初始化的 Canvas 元素
+     * @param callback 执行的回调，这里要对页面背景进行更新
+     * @param _Ripples  上一个回调在使用中的 this
+     */
+    constructor(canvas: HTMLCanvasElement, callback: () => void, _Ripples: Ripples);
+    /**  销毁  */
+    destroy(): void;
+}