enr 0.2.3-alpha.2

package/components/layout/sidebar.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @license MIT
+ * earthnut@components/layout/sidebar.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { LayoutSideBarProps } from './types';
+/**
+ *
+ * children side bar
+ *
+ * 侧边栏
+ *
+ *
+ * @param children 子元素
+ * @param ref 组件引用
+ * @param props 组件属性
+ * @param className 自定义类名
+ * @param width 侧边栏的宽度
+ *  缺省值为 `150px`
+ * @param right 是否居右
+ *  缺省值为 `false`
+ * @param full 是否占用所有空间
+ *  缺省值为 `false`
+ * @returns `ReactElement`;
+ *
+ */
+declare const InternalValueS: import("react").ForwardRefExoticComponent<LayoutSideBarProps & import("react").RefAttributes<HTMLDivElement>>;
+export { InternalValueS };

package/components/layout/types.d.ts

@@ -0,0 +1,99 @@
+/**
+ * @license MIT
+ * earthnut@components/layout/types.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { CSSProperties, HTMLAttributes } from 'react';
+/**
+ * 布局
+ */
+export interface LayoutProps extends HTMLAttributes<HTMLDivElement> {
+    classes?: string | string[];
+    /**  布局的  */
+    /**
+     * 布局的宽
+     *
+     *
+     * 缺省值为 100vw
+     */
+    width?: string | number;
+    /**
+     * 布局可视界面的高
+     *
+     * 用于限制 side bar 的高度
+     *
+     * 缺省值为 100vh
+     *
+     * 为具体值。当为 100% 时 side bar 渲染不正确
+     */
+    height?: string | number;
+    /**  其他的组件样式  */
+    /**  样式  */
+    style?: CSSProperties;
+    /**  其他的组件样式  */
+    theme?: LayoutTheme;
+}
+/**  侧边 sidebar 的参数  */
+export interface LayoutSideBarProps extends HTMLAttributes<HTMLDivElement> {
+    classes?: string | string[];
+    /**
+     * 侧边栏的宽度
+     *
+     * 缺省值为 150
+     */
+    width?: number | string;
+    /**
+     * 是否居右
+     *
+     * 缺省值为 false
+     */
+    right?: boolean;
+    /**
+     * 是否占用所有空间
+     *
+     * 缺省值为 false
+     */
+    full?: boolean;
+}
+/**  Header 的 props   */
+export interface LayoutHeaderProps extends HTMLAttributes<HTMLDivElement> {
+    classes?: string | string[];
+    /**
+     * header 的高度
+     *
+     * 缺省值为 2.8rem
+     */
+    height?: number | string;
+    /**
+     * 是否取消悬挂粘连
+     *
+     * 缺省值为 false
+     */
+    noSticky?: boolean;
+}
+/**  脚组件的参数类型  */
+export interface LayoutFooterProps extends HTMLAttributes<HTMLDivElement> {
+    classes?: string | string[];
+    /**
+     * footer 的高度
+     *
+     * 缺省值为 2rem
+     */
+    height?: number | string;
+}
+/**  定义布局主题类型  */
+export interface LayoutTheme {
+    /**  组件的宽  */
+    layoutWith: string | number;
+    /**  组件的高  */
+    layoutHeight: string | number;
+    /**  侧边的宽  */
+    sideBarWidth: string | number;
+    /**  头部的高  */
+    headerHeight: string | number;
+    /**  底部的高  */
+    footerHeight: string | number;
+}
+/**  可使用的样式类型  */
+export type EnLayoutContentType = 'simple' | 'only-footer' | 'only-header' | 'no-sidebar' | 'side-full' | 'side-right-full-all' | 'side-right-full-no-footer' | 'side-right-full-no-header' | 'side-right-full-only-side' | 'side-right-all' | 'side-right-no-footer' | 'side-right-no-header' | 'side-right-only-side' | 'side-full-all' | 'side-full-no-footer' | 'side-full-no-header' | 'side-full-only-side' | 'simple-all' | 'simple-no-footer' | 'simple-no-header' | 'simple-only-side';

package/components/marquee/MarqueeEle.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license MIT
+ * earthnut@components/marquee/MarqueeEle.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { HTMLAttributes } from 'react';
+import { MarqueeProps } from './type';
+import './index.scss';
+/**
+ *  一个跑马灯一样的东东
+ *
+ */
+declare const MarqueeEle: import("react").ForwardRefExoticComponent<HTMLAttributes<HTMLDivElement> & MarqueeProps & import("react").RefAttributes<HTMLDivElement>>;
+export { MarqueeEle };

package/components/marquee/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license MIT
+ * earthnut@components/marquee/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export { MarqueeEle as Marquee, MarqueeEle as EnMarquee } from './MarqueeEle';

package/components/marquee/type.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@components/marquee/type.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export type MarqueeProps = {
+    borderRadius?: string;
+};

package/components/menu/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license MIT
+ * earthnut@components/menu/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */

package/components/menu/menu.d.ts

@@ -0,0 +1,6 @@
+/**
+ * @license MIT
+ * earthnut@components/menu/menu.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */

package/components/ripples/Content.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * earthnut@components/ripples/Content.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  内容组件  */
+export declare const Content: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;

package/components/ripples/LazyRippleEle.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license MIT
+ * earthnut@components/ripples/LazyRippleEle.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RipplesOptions } from '../../customHooks/useRipples/types';
+import { RippleEle } from './types';
+/**
+ *
+ * ### 一个 ripple 背景组件
+ *
+ *
+ * *需要为该组件或父组件设置背景，否则即便的渲染了，效果不明显*
+ *
+ *  参数 props 属性：
+ * - children 内嵌的 ReactNode
+ * - style    更改显示的样式
+ * - option   初始化 ripples 的原始数据
+ * @param props  使用参数
+ * @version 0.0.1
+ * @see https://earthnut.dev/earthnut/lazy-background-ripple
+ * @example
+ * 使用：
+ *
+ * ```ts
+ *  import { BackgroundRipple } from 'earthnut/BackgroundRipple';
+ *  // 也可以全量导入
+ *  // import { BackgroundRipple } from 'earthnut';
+ *  ...
+ *  const animationFrameId = useAnimationFrame();
+ *
+ *  return <BackgroundRipple>
+ *            ...
+ *         </BackgroundRipple>
+ * ```
+ *
+ */
+declare const LazyBackgroundRipple: import("react").ForwardRefExoticComponent<import("react").HTMLAttributes<HTMLDivElement> & {
+    option?: RipplesOptions;
+} & import("react").RefAttributes<RippleEle>>;
+export { LazyBackgroundRipple };

package/components/ripples/RipplesEle.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @license MIT
+ * earthnut@components/ripples/RipplesEle.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RipplesOptions } from '../../customHooks/useRipples/types';
+import { RippleEle } from './types';
+/**
+ *
+ * ### 一个 ripple 背景组件
+ *
+ *
+ * *需要为该组件或父组件设置背景，否则即便的渲染了，效果不明显*
+ *
+ *  参数 props 属性：
+ * - children 内嵌的 ReactNode
+ * - style    更改显示的样式
+ * - option   初始化 ripples 的原始数据
+ * @param props  使用参数
+ * @version 0.0.1
+ * @see https://earthnut.dev/earthnut/background-ripple
+ * @example
+ * 使用：
+ *
+ * ```ts
+ *  import { BackgroundRipple } from 'earthnut';
+ *  // 也可以全量导入
+ *  // import { BackgroundRipple } from 'earthnut';
+ *  ...
+ *  const animationFrameId = useAnimationFrame();
+ *
+ *  return <BackgroundRipple>
+ *            ...
+ *         </BackgroundRipple>
+ * ```
+ *
+ */
+declare const BackgroundRipple: import("react").ForwardRefExoticComponent<import("react").HTMLAttributes<HTMLDivElement> & {
+    option?: RipplesOptions;
+} & import("react").RefAttributes<RippleEle>>;
+export { BackgroundRipple };

package/components/ripples/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @license MIT
+ * earthnut@components/ripples/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RippleEle } from './types';
+export { BackgroundRipple } from './RipplesEle';
+export { LazyBackgroundRipple } from './LazyRippleEle';
+export type { Ripples, BackgroundRipplesProps, RipplesOptions, RippleImgUrl, } from '../../customHooks/useRipples/index';
+export type { RippleEle };

package/components/ripples/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license MIT
+ * earthnut@components/ripples/types.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RipplesOptions } from '../../customHooks/useRipples';
+export type RippleEle = {
+    /**  切换当前的状态  */
+    toggleState(): void;
+    /**  获取当前的状态  */
+    state: boolean;
+    /**  暂停当前涟漪的渲染  */
+    pause(): void;
+    /**  设置属性 */
+    set(options?: RipplesOptions): void;
+};

package/components/ripples/useOptionUpdate.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license MIT
+ * earthnut@components/ripples/useOptionUpdate.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples, RipplesOptions } from '../../customHooks/useRipples/index';
+import { RefObject } from 'react';
+/**
+ * 更新参数数据
+ */
+export declare function useOptionUpdate(ripplesRef: RefObject<Ripples | null>, option: RipplesOptions | undefined): void;

package/components/shared/EnLayoutContent/index.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license MIT
+ * earthnut@components/shared/EnLayoutContent/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { EnLayoutContentProps } from './types';
+/**  创建带样式的组件  */
+export declare const LayoutContentContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement>, never>> & string;
+/**  带样式的组件  */
+export declare const LayoutFooterContent: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+/**  带样式的头部  */
+export declare const LayoutHeaderContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement>, never>> & string;
+/**  带样式的组件  */
+export declare const LayoutSideBarContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLElement>, HTMLElement>, never>> & string;
+/**  内容区域容器  */
+export declare const LayoutContentWrapper: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;
+/**  元始的外壳  */
+export declare const EnLayoutContent: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, EnLayoutContentProps>> & string;

package/components/shared/EnLayoutContent/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @license MIT
+ * earthnut@components/shared/EnLayoutContent/types.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { EnLayoutContentType } from 'components/layout/types';
+/**  组件的样式  */
+export interface EnLayoutContentProps {
+    $header: string;
+    $content: string;
+    $sidebar: string;
+    $footer: string;
+    $main: string;
+    $headerNoSticky: boolean;
+    $layoutType: EnLayoutContentType;
+}

package/components/switch/SwitchContainer.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @license MIT
+ * earthnut@components/switch/SwitchContainer.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export declare const SwitchContainer: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components").FastOmit<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, never>> & string;

package/components/switch/SwitchContent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @license MIT
+ * earthnut@components/switch/SwitchContent.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  开关的内容包装  */
+export declare const SwitchContent: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    $type: "left" | "right";
+}>> & string;

package/components/switch/SwitchLabel.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@components/switch/SwitchLabel.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export declare const SwitchLabel: import("styled-components/dist/types").IStyledComponentBase<"web", import("styled-components/dist/types").Substitute<import("react").DetailedHTMLProps<import("react").HTMLAttributes<HTMLDivElement>, HTMLDivElement>, {
+    $type: boolean;
+}>> & string;

package/components/switch/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license MIT
+ * earthnut@components/switch/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { HTMLAttributes } from 'react';
+/**
+ *  开关
+ */
+export declare function Switch({ value, change, children, ...props }: {
+    value: boolean;
+    change?: (e?: React.MouseEvent) => void;
+} & HTMLAttributes<HTMLDivElement>): import("react").JSX.Element;

package/customHooks/use-xcn/index.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/use-xcn/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  其实这并不是一个自定义钩子  */
+import { EnTypeofClassNameItem, EnXcn } from 'xcn';
+type EnClassName = 'en-flex' | 'en-flex-row' | 'en-flex-row-reverse' | 'en-flex-column' | 'en-flex-column-reverse' | 'en-flex-wrap' | 'en-full-container' | 'en-inline-block' | 'en-padding-horizontal-4' | 'en-padding-horizontal-8' | 'en-padding-horizontal-12' | 'en-padding-horizontal-16' | 'en-padding-horizontal-20' | 'en-padding-horizontal-24' | 'en-padding-horizontal-28' | 'en-padding-horizontal-32' | 'en-padding-horizontal-36' | 'en-padding-horizontal-40' | 'en-padding-vertical-4' | 'en-padding-vertical-8' | 'en-padding-vertical-12' | 'en-padding-vertical-16' | 'en-padding-vertical-20' | 'en-padding-vertical-24' | 'en-padding-vertical-28' | 'en-padding-vertical-32' | 'en-padding-vertical-36' | 'en-padding-vertical-40' | 'en-padding-4' | 'en-padding-8' | 'en-padding-12' | 'en-padding-16' | 'en-padding-20' | 'en-padding-24' | 'en-padding-28' | 'en-padding-32' | 'en-padding-36' | 'en-padding-40' | 'en-margin-horizontal-4' | 'en-margin-horizontal-8' | 'en-margin-horizontal-12' | 'en-margin-horizontal-16' | 'en-margin-horizontal-20' | 'en-margin-horizontal-24' | 'en-margin-horizontal-28' | 'en-margin-horizontal-32' | 'en-margin-horizontal-36' | 'en-margin-horizontal-40' | 'en-margin-vertical-4' | 'en-margin-vertical-8' | 'en-margin-vertical-12' | 'en-margin-vertical-16' | 'en-margin-vertical-20' | 'en-margin-vertical-24' | 'en-margin-vertical-28' | 'en-margin-vertical-32' | 'en-margin-vertical-36' | 'en-margin-vertical-40' | 'en-margin-4' | 'en-margin-8' | 'en-margin-12' | 'en-margin-16' | 'en-margin-20' | 'en-margin-24' | 'en-margin-28' | 'en-margin-32' | 'en-margin-36' | 'en-margin-40' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-box-shadow-light-red100' | 'en-border-radius-4' | 'en-border-radius-8' | 'en-border-radius-12' | 'en-border-radius-16' | 'en-border-radius-20' | 'en-border-radius-24' | 'en-border-radius-28' | 'en-border-radius-32' | 'en-border-radius-36' | 'en-border-radius-40' | 'en-center' | 'en-dust' | 'en-text-in-one-line' | 'en-text-in-one-line-hide' | 'en-text-in-two-line' | 'en-color-text' | 'en-bg-red' | 'en-float-left' | 'en-float' | 'en-float-right' | 'en-clear-float' | 'en-clear' | 'en-loading' | 'en-text-center' | 'en-text-right' | 'eb-text-small' | 'en-relative' | 'en-user-select-text' | 'en-cursor-pointer';
+/**  在 xcn 中使用 earthnut 样式类 */
+export declare function _en<T extends EnClassName[]>(...classNameList: T): EnXcn<{
+    [K in keyof T]: EnTypeofClassNameItem<T[K]>;
+}>;
+export {};

package/customHooks/useAnimationFrame.d.ts

@@ -0,0 +1,58 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useAnimationFrame.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  使用动画结果  */
+export interface UseAnimationFrameResult {
+    /**  取消执行动画  */
+    cancel(): void;
+    /**  当前取消的状态  */
+    canceled: boolean;
+    /**  再次执行  */
+    render(): void;
+}
+export type AnimationFrameOption = boolean | {
+    immediately?: boolean;
+    once?: boolean;
+};
+/**
+ *
+ *  该钩子在组件卸载时会自动调用 `window.cancelAnimationFrame` 清理传入的回调方法。
+ *  默认是传入即启动调用方法
+ *
+ * @description 创建一个会自己关闭（组建卸载时）的 animationFrame。当然，可以通过返回值手动终止
+ * @param callback  使用回调函数。回调函数有两个参数，除了默认的时间，还有另一个用于暂停后的记时时间。如果没有主动暂停，两者时间总是趋近于相等的（可能有其他延迟造成时间差越来越大）。如果没有暂停需求，使用第一个默认时间就可以了。
+ * @param [option=false] 使用第二参数，可指定是否立即执行及是否仅执行一次
+ * @returns  返回值包含执行状态
+ * @version 0.2.0
+ * @see   https://earthnut.dev/custom-hooks/use-animation-frame
+ * @example
+ * 使用：
+ *
+ * ```ts
+ *  // import { useAnimationFrame } from 'earthnut';
+ *  ...
+ *
+ *  export function Home () {
+ *  // 如果没有主动暂停的需要，直接使用默认的 time 最好。如果中间有使用暂停。那么 time 值是不连贯的，而 runTime 是连贯的
+ *  const result = useAnimationFrame((time ,runTime) => {
+ *     ... //
+ *  });
+ *
+ *
+ * return <>
+ *
+ *    <button onclick={() => result.cancel()}>暂停</button>
+ *    <button onclick={() => result.render()}>恢复</button>
+ *   </>
+ * }
+ *  ...
+ *
+ * ```
+ *
+ * 当然，可使用第二参数执行立即执行还是仅执行一次（作用不大，不与赘述）
+ *
+ */
+export declare function useAnimationFrame(callback: (time: number, runtime: number) => void, option?: AnimationFrameOption): UseAnimationFrameResult;

package/customHooks/useInputIsComposing.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useInputIsComposing.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RefObject } from 'react';
+/**
+ *
+ * ### 导出一个使用 `useRef` 创建的 `boolean`
+ *
+ *  *由于是包裹在 RefObject 之中，判断时务必使用 `isComposing.current` 进行判断*
+ * @description 用于判断当前的输入状态是否结束
+ * @param inputRef [RefObject<HTMLInputElement | HTMLTextAreaElement>] 输入框的 ref
+ * @returns  RefObject<boolean>
+ * @version 0.0.4
+ * @see   https://earthnut.dev/custom-hooks/use-input-is-composing
+ * @example
+ *
+ * 使用：
+ *
+ * ```ts
+ *  import { useInputIsComposing } from 'earthnut';
+ *
+ *  ...
+ *  const inputRef = useRef<HTMLInputElement>(null);
+ *
+ *  const inputIsComposing = useInputIsComposing(inputRef);
+ *  ...
+ *  function enterDown(e: React.KeyboardEvent<HTMLInputElement>) {
+ *     if (e.key === 'Enter') {
+ *        if (isComposing.current) {
+ *            console.log("此时此景，按回车键说明为了从候选词中挑选");
+ *        } else {
+ *           console.log("输入完毕，敲回车是为了看一些开发者是否绑定了其他事件");
+ *        }
+ *     }
+ *  }
+ *  ...
+ *  <input type="text" onKeyDown={enterDown} ref={inputRef} />
+ *  ...
+ * ```
+ */
+export declare function useInputIsComposing(inputRef: RefObject<HTMLInputElement | HTMLTextAreaElement | null>): RefObject<boolean>;

package/customHooks/useRipples/buildBackground/create-background-color.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/create-background-color.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**  构建背景色  */
+export declare function createBackgroundColor(this: Ripples): void;

package/customHooks/useRipples/buildBackground/create-linear-gradient.d.ts

@@ -0,0 +1,9 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/create-linear-gradient.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**  构建渐变背景色图  */
+export declare function createLinearGradient(this: Ripples): void;

package/customHooks/useRipples/buildBackground/default-background/_createImageData.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/default-background/_createImageData.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../../ripplesClass';
+/**
+ * 创建一个隐含像素数据的区域
+ *
+ * 用于构建默认的背景图
+ */
+export declare function createImageData(this: Ripples, bindImage: () => void): void;

package/customHooks/useRipples/buildBackground/default-background/circleDataList.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/default-background/circleDataList.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  圆数据  */
+export declare const circleDataList: {
+    /**  计数器  */
+    #cum: number;
+    /**  构建新的数据依据  */
+    build(darkMode: boolean): void;
+    /**  数据依据  */
+    data: {
+        /**  数据  */
+        list: [number, number, number, number][][];
+        /**  直径  */
+        diameter: number;
+        /**  半径  */
+        radius: number;
+        /**  晶格数  */
+        cells: number;
+    };
+};

package/customHooks/useRipples/buildBackground/default-background/createCanvasElementBySize.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/default-background/createCanvasElementBySize.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  通过尺寸创建一个默认图  */
+export declare function createCanvasElementBySize(width: number, height: number): HTMLCanvasElement;

package/customHooks/useRipples/buildBackground/default-background/createDefault.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/default-background/createDefault.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  构建默认的背景图  */
+export declare function createDefault(width: number, height: number): ImageData;

package/customHooks/useRipples/buildBackground/default-background/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/default-background/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../../ripplesClass';
+/**
+ *
+ * 设置透明的纹理
+ *
+ *
+ * 透明的纹理*默认会自动切换*
+ *
+ * @param [executeImmediately=true]  立即执行
+ *
+ */
+export declare function setTransparentTexture(this: Ripples, executeImmediately?: boolean): void;

package/customHooks/useRipples/buildBackground/load-image.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @license MIT
+ * earthnut@customHooks/useRipples/buildBackground/load-image.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from '../ripplesClass';
+/**
+ *
+ * 加载图像
+ *
+ * - 初始化的时候首先触发加载背景图像
+ * - 通过 Ripple 的 set 方法设置属性 imgUrl 值时将触发
+ * - 尺寸发生变化时亦将触发更改
+ * - 父元素的样式属性发生变更时也会触发
+ *
+ * 在加载过程中如果渲染的图片为非法的（加载错误）那么将查找当前的背景色或是背景图作为依据，再就是都没有的情况下将会渲染一个类似于旧地板的色
+ */
+export declare function loadImage(this: Ripples): void;