oops-ui 0.0.13 → 1.0.1

package/type/customHooks/useRipples/rippersData/useOptions.d.ts

@@ -0,0 +1,91 @@
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/rippersData/useOptions.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { ImageCrossOrigin, RippleImgUrl, RipplesUseOptions } from '../types';
+/** 用户使用参数  */
+export declare class UseOptions {
+    #private;
+    /**  倍级触发光标事件  */
+    set accelerating(value: number);
+    /**
+     * 倍级触发光标事件
+     */
+    get accelerating(): number;
+    /**  是否与鼠标互动  */
+    set interactive(value: boolean);
+    /**
+     * 是否与鼠标互动
+     */
+    get interactive(): boolean;
+    /**  分辨率
+     *
+     * 纹理的尺寸，该项目中该值为纹理的宽和高
+     *
+     */
+    set resolution(value: number);
+    /**
+     * 纹理的尺寸，该项目中该值为纹理的宽和高
+     */
+    get resolution(): number;
+    /**
+     * 扰动系数
+     *
+     * 缺省 `0.01`
+     *
+     * 取之范围 `0.01 - 1`
+     */
+    set perturbance(value: number);
+    /**
+     * 扰动系数
+     */
+    get perturbance(): number;
+    /**
+     * 扩散半径
+     *
+     * 缺省为 `20`
+     */
+    set dropRadius(value: number);
+    /**
+     * 扩散半径
+     */
+    get dropRadius(): number;
+    /**  传入的背景图片  */
+    imgUrl: RippleImgUrl;
+    /**  闲置波动  */
+    set idleFluctuations(value: boolean);
+    /**
+     * 闲置波动
+     */
+    get idleFluctuations(): boolean;
+    /**  雨滴落下的时间间隔  */
+    set raindropsTimeInterval(value: number);
+    /**
+     * 雨滴落下的时间间隔
+     */
+    get raindropsTimeInterval(): number;
+    /**  crossOrigin  （是否跨域） */
+    crossOrigin: ImageCrossOrigin;
+    /**  canvas 的显隐  */
+    visible: boolean;
+    /**  当前执行的状态  */
+    running: boolean;
+    /**  当前执行的状态  */
+    set playingState(value: boolean);
+    /**
+     * 当前执行的状态
+     */
+    get playingState(): boolean;
+    /**  当前时候为暗黑模式  */
+    get darkMode(): boolean | undefined;
+    /**  当前时候为暗黑模式  */
+    set darkMode(value: boolean | undefined);
+    /**  上一次执行渲染状态  */
+    lastRunningState: boolean;
+    /**
+     * 构建使用参数的数据
+     */
+    constructor(options: RipplesUseOptions);
+}

package/{dist/types → type}/customHooks/useRipples/rippersData/vertexSource.d.ts

@@ -1,28 +1,34 @@
-/**************************
- *
- **************************/
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/rippersData/vertexSource.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**
+ *
+ */
 export declare const vertexShader = "\n      attribute vec2 vertex;\n      varying vec2 coord;\n      void main() {\n        coord = vertex * 0.5 + 0.5;\n        gl_Position = vec4(vertex, 0.0, 1.0);\n      }";
-/**************************************
+/**
  *
  *
  *
- **************************************/
+ */
 export declare const updateProgramFragmentSource = "\n      precision highp float;\n\n      uniform sampler2D texture;\n      uniform vec2 delta;\n\n      varying vec2 coord;\n\n      void main() {\n        vec4 info = texture2D(texture, coord);\n  \n        vec2 dx = vec2(delta.x, 0.0);\n        vec2 dy = vec2(0.0, delta.y);\n  \n        float average = (\n          texture2D(texture, coord - dx).r +\n          texture2D(texture, coord - dy).r +\n          texture2D(texture, coord + dx).r +\n          texture2D(texture, coord + dy).r\n        ) * 0.25;\n  \n        info.g += (average - info.r) * 2.0;\n        info.g *= 0.995;\n        info.r += info.g;\n  \n        gl_FragColor = info;\n      }\n      ";
-/**************************************
+/**
  *
  *
  *
- **************************************/
+ */
 export declare const renderVertexSource = "\n        precision highp float;\n\n        attribute vec2 vertex;\n        uniform vec2 topLeft;\n        uniform vec2 bottomRight;\n        uniform vec2 containerRatio;\n        varying vec2 ripplesCoord;\n        varying vec2 backgroundCoord;\n        void main() {\n          backgroundCoord = mix(topLeft, bottomRight, vertex * 0.5 + 0.5);\n          backgroundCoord.y = 1.0 - backgroundCoord.y;\n          ripplesCoord = vec2(vertex.x, -vertex.y) * containerRatio * 0.5 + 0.5;\n          gl_Position = vec4(vertex.x, -vertex.y, 0.0, 1.0);\n        }\n      ";
-/**************************************
+/**
  *
  *
  *
- **************************************/
+ */
 export declare const renderProgramFragmentSource = "\n        precision highp float;\n\n        uniform sampler2D samplerBackground;\n        uniform sampler2D samplerRipples;\n        uniform vec2 delta;\n\n        uniform float perturbance;\n        varying vec2 ripplesCoord;\n        varying vec2 backgroundCoord;\n\n        void main() {\n          float height = texture2D(samplerRipples, ripplesCoord).r;\n          float heightX = texture2D(samplerRipples, vec2(ripplesCoord.x + delta.x, ripplesCoord.y)).r;\n          float heightY = texture2D(samplerRipples, vec2(ripplesCoord.x, ripplesCoord.y + delta.y)).r;\n          vec3 dx = vec3(delta.x, heightX - height, 0.0);\n          vec3 dy = vec3(0.0, heightY - height, delta.y);\n          vec2 offset = -normalize(cross(dy, dx)).xz;\n          float specular = pow(max(0.0, dot(offset, normalize(vec2(-0.6, 1.0)))), 4.0);\n          gl_FragColor = texture2D(samplerBackground, backgroundCoord + offset * perturbance) + specular;\n        }";
-/**************************************
+/**
  *
  * fragmentSource
  *
- **************************************/
+ */
 export declare const dropProgramFragmentSource = "precision highp float;\n\n      const float PI = 3.141592653589793;\n      uniform sampler2D texture;\n      uniform vec2 center;\n      uniform float radius;\n      uniform float strength;\n\n      varying vec2 coord;\n\n      void main() {\n        vec4 info = texture2D(texture, coord);\n\n        float drop = max(0.0, 1.0 - length(center * 0.5 + 0.5 - coord) / radius);\n        drop = 0.5 - cos(drop * PI) * 0.5;\n        info.r += drop * strength;\n        gl_FragColor = info;\n      }";

package/type/customHooks/useRipples/ripple.html.d.ts

@@ -0,0 +1,12 @@
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/ripple.html.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { Ripples } from './ripplesClass';
+import { RipplesOptions } from './types';
+/**
+ * ripple 的 html 导出，不依赖于 react
+ */
+export declare function useRipples(element: HTMLElement, options: RipplesOptions): Ripples;

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

@@ -0,0 +1,57 @@
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/ripplesClass.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RipplesData } from './rippersData';
+import { RipplesOptions } from './types';
+import { RipplesRenderData } from './rippersData/renderData';
+import { UseOptions } from './rippersData/useOptions';
+import { FadeData } from './rippersData/fadeData';
+/**
+ *
+ * ## 水波动涟漪的效果
+ *
+ * 魔改自大佬的[jQuey 代码](https://github.com/sirxemic/jquery.ripples)
+ */
+export declare class Ripples extends RipplesData {
+    #private;
+    /**  渲染数据  */
+    renderData: RipplesRenderData | null;
+    /**  使用参数  */
+    options: UseOptions;
+    /**  背景使用的数据  */
+    fadeData: FadeData;
+    defaults: import("./types").RipplesDefaultData;
+    /**  初始化状态  */
+    initialized: boolean;
+    /**
+     * 构建 Ripple 对象
+     */
+    constructor(canvas: HTMLCanvasElement, options?: RipplesOptions);
+    /** 模拟雨滴下落  */
+    raindropsFall(): void;
+    /** 公共方法，触发 */
+    drop(x: number, y: number, radius: number, strength: number): void;
+    /**
+     * 缓进缓出
+     */
+    fade(): void;
+    /** 元素的尺寸发生变化  */
+    reloadBackground(): void;
+    /**  销毁  */
+    destroy(): void;
+    /**  展示元素 */
+    show(): void;
+    /** 隐藏元素 */
+    hide(): void;
+    /** 暂停动画涟漪状态   */
+    pause(): void;
+    /**  播放动画涟漪状态  */
+    play(): void;
+    /** 切换当前状态   */
+    changePlayingState(): void;
+    /**  给初始化变量赋值  */
+    set(property: keyof RipplesOptions, value: unknown): void;
+}

package/{dist/types → type}/customHooks/useRipples/tools.d.ts

@@ -1,6 +1,12 @@
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/tools.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
 /****************************************************************************
- * @Author lmssee
- * @Email lmssee@outlook.com
+ * @Author earthnut
+ * @Email earthnut.dev@outlook.com
  * @ProjectName website
  * @FileName tools.ts
  * @CreateDate  周六  12/07/2024
@@ -8,20 +14,24 @@
  ****************************************************************************/
 import { Ripples } from './ripplesClass';
 import { Program } from './types';
-/**************************************
+/**
  *
  *  增加 WebGLProgram
  *
  *
- **************************************/
+ */
 export declare function createProgram(vertexSource: string, fragmentSource: string, gl: WebGLRenderingContext, _uniformValues?: string): Program;
-/**************************************
+/**
  *
  * 绑定纹理
  *
- **************************************/
+ */
 export declare function bindTexture(this: Ripples, texture: WebGLTexture, unit?: number): void;
-/**************************
+/**
  * 给 canvas 设置样式
- **************************/
+ */
 export declare function setCanvasStyle(canvas: HTMLCanvasElement): void;
+/**  背景色值为空  */
+export declare function isNoneBackGroundColor(color: string): boolean;
+/**  背景图为空  */
+export declare function isNoneBackgroundImage(src: string): boolean;

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

@@ -0,0 +1,209 @@
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/types.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/****************************************************************************
+ * @Author earthnut
+ * @Email earthnut.dev@outlook.com
+ * @ProjectName react-ripples
+ * @FileName interface.ts
+ * @CreateDate  周二  12/17/2024
+ * @Description BackgroundRipples 的类型声明文件
+ ****************************************************************************/
+import { HTMLAttributes } from 'react';
+export type ImageCrossOrigin = 'anonymous' | 'use-credentials' | 'no-cors';
+/**
+ *
+ *  背景涟漪的 props 类型
+ *
+ * - children  可选属性，定义子组件或子组件们
+ * - style     可选属性，定义自定义外壳的样式，在内含 `children` 时生效
+ * - option    可选属性，自定义涟漪的初始化属性
+ *    - resolution 分辨率,纹理的尺寸，该项目中该值为纹理的宽和高，缺省为 `256`
+ *    - dropRadius 扩撒半径，缺省值为 `20`
+ *    - perturbance 扰动系数，缺省为   `0.03`
+ *    - interactive 光标交互，缺省为 `true` ，关闭须显示传入 `false` 值
+ *    - accelerating  加速光标移动触发，缺省为 `1`
+ *    - crossOrigin 原始样式
+ *    - imgUrl    原始背景图片地址
+ *    - playingState 当前的播放状态，缺省为 `true` ，设定为 `false` 时并不关闭，而是暂停
+ *    - raindropsTimeInterval 雨滴滴落的间隔，缺省为 `3600`，可设置区间为 `10 ~ 12000`
+ *           该值还将影响无背景设置时默认背景的切换频率，几乎每两个雨滴落下就会切换一次背景
+ *    - idleFluctuations  闲置波动，在光标交互不触发时，将触发模拟雨滴，缺省为 `true`
+ *    - darkMode 暗黑模式，仅用于在默认的背景图时更改默认背景图的背景色，如果使用了 `imgUrl` 配置，请执行处理色差异常
+ *
+ */
+export type BackgroundRipplesProps = HTMLAttributes<HTMLDivElement> & {
+    /**
+     * ## 可设定涟漪的参数
+     *
+     * - resolution  波速，值越小，波动越快。缺省为 `360`
+     * - dropRadius  波动强度，值越小，波动效果越大，缺省值为 `12`
+     * - perturbance 扰动系数，值越大，对原背景造成干涉越强，缺省为   `0.01`
+     * - interactive 光标交互，缺省为 `true` ，关闭须显示传入 `false` 值
+     * - accelerating  加速光标移动触发，类似于扰动系数，及作用与鼠标或手指触发，缺省为 `1`
+     * - crossOrigin 原始样式
+     * - imgUrl    原始背景图片地址
+     * - playingState 当前的播放状态，缺省为 `true` ，设定为 `false` 时并不关闭，而是暂停
+     * - raindropsTimeInterval 雨滴滴落的间隔，缺省为 `3650`，可设置区间为 `10 ~ 12000`，值越小，雨越大
+     *   该值还将影响无背景设置时默认背景的切换频率，几乎每两个雨滴落下就会切换一次背景
+     * - idleFluctuations  闲置波动，在光标交互不触发时，将触发模拟雨滴，缺省为 `true`
+     * - darkMode 暗黑模式，仅用于在默认的背景图时更改默认背景图的背景色，如果使用了 `imgUrl` 配置，请执行处理色差异常
+     */
+    option?: RipplesOptions;
+};
+/**
+ *
+ * WebGLProgram
+ *
+ */
+export interface Program {
+    id: WebGLProgram;
+    uniforms: {
+        [x: string]: Float32Array;
+    };
+    locations: {
+        [x: string]: WebGLUniformLocation;
+    };
+}
+/**
+ * 设定的元素背景的 url 地址
+ *
+ * 缺省为 `null`
+ */
+export type RippleImgUrl = string | string[] | null;
+export type RipplesUseOptions = {
+    /**
+     * 波速
+     *
+     * 作用为波传播的速度，值越大，波传播的越慢
+     *
+     * 缺省为 `360`
+     */
+    resolution: number;
+    /**
+     * 波动强度
+     *
+     * 值越小，波动越明显
+     *
+     * 缺省为 `12`
+     */
+    dropRadius: number;
+    /**
+     * 扰动系数
+     *
+     * 缺省 `0.01`
+     *
+     * 取之范围 `0.01 - 1`
+     *
+     * 值越大，扰动效果越明显
+     */
+    perturbance: number;
+    /**
+     * 是否开启光标滑动轨迹
+     *
+     * 缺省为  `true`
+     */
+    interactive: boolean;
+    /**
+     * 加速光标移动触发，缺省为 `1`
+     *
+     *
+     * 由于大佬原方法在光标触发 mousemove 时不怎么明显
+     *
+     * 所以以倍级触发会让波动更加明显
+     *
+     * 可设置区间为 `2 - 100`
+     */
+    accelerating: number;
+    /**
+     *  原设定的背景图片
+     *
+     * 缺省为 `''`
+     */
+    crossOrigin: ImageCrossOrigin;
+    /**
+     * 设定的元素背景的 url 地址
+     *
+     * 缺省为 `null`
+     */
+    imgUrl: RippleImgUrl;
+    /**
+     * 当前涟漪的状态
+     *
+     * 缺省为 `true` ， 即涟漪触发正在执行
+     */
+    playingState: boolean;
+    /**
+     * 雨滴滴落的时间间隔
+     *
+     * 单位为 ms
+     *
+     * 缺省值为 `3600`
+     *
+     *
+     * 可设置区间为 `10 ~ 12000`
+     *
+     *   该值还将影响无背景设置时默认背景的切换频率，几乎每两个雨滴落下就会切换一次背景
+     */
+    raindropsTimeInterval: number;
+    /**
+     * 闲置波动
+     *
+     * 在光标交互不触发时，将触发模拟雨滴
+     *
+     * 缺省为 `true`
+     */
+    idleFluctuations: boolean;
+    /**
+     *  是否为暗黑模式
+     *
+     *  在使用默认的主题设置时，当页面使用暗黑模式时出现了文本看不清的现象
+     *
+     */
+    darkMode: boolean | undefined;
+};
+/**
+ *
+ * 涟漪设定参数
+ *
+ * - resolution 分波速，值越小，波动越快。缺省为 `360`
+ * - dropRadius 波动强度，值越小，波动效果越大，缺省值为 `12`
+ * - perturbance 扰动系数，值越大，对原背景造成干涉越强，缺省为   `0.01`
+ * - interactive 光标交互，缺省为 `true` ，关闭须显示传入 `false` 值
+ * - accelerating  加速光标移动触发，类似于扰动系数，及作用与鼠标或手指触发，缺省为 `1`
+ * - crossOrigin 原始样式
+ * - imgUrl    原始背景图片地址
+ * - playingState 当前的播放状态，缺省为 `true` ，设定为 `false` 时并不关闭，而是暂停
+ * - raindropsTimeInterval 雨滴滴落的间隔，缺省为 `3650`，可设置区间为 `10 ~ 12000`，值越小，雨越大
+ *   该值还将影响无背景设置时默认背景的切换频率，几乎每两个雨滴落下就会切换一次背景
+ * - idleFluctuations  闲置波动，在光标交互不触发时，将触发模拟雨滴，缺省为 `true`
+ * - darkMode 暗黑模式，仅用于在默认的背景图时更改默认背景图的背景色，如果使用了 `imgUrl` 配置，请执行处理色差异常
+ */
+export type RipplesOptions = {
+    [x in keyof RipplesUseOptions]?: RipplesUseOptions[x];
+};
+/**
+ * 初始默认值
+ */
+export interface RipplesDefaultData {
+    /**  默认的图像地址  */
+    imgUrl: null;
+    /**    */
+    resolution: 360;
+    dropRadius: 12;
+    perturbance: 0.01;
+    interactive: true;
+    crossOrigin: 'no-cors';
+    playingState: true;
+    accelerating: 1;
+    raindropsTimeInterval: 3600;
+    idleFluctuations: true;
+    darkMode: undefined;
+}
+/**
+ *
+ */
+export type Textures = WebGLTexture[];

package/type/customHooks/useRipples/use-lazy-ripple.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @license MIT
+ * enr@type/customHooks/useRipples/use-lazy-ripple.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { RefObject } from 'react';
+import { Ripples } from './ripplesClass';
+import { RipplesOptions } from './types';
+/**  动态加载包含的自定义的钩子  */
+export declare function useLazyRipples(canvas: RefObject<HTMLCanvasElement | null>, option?: RipplesOptions): {
+    ripples: RefObject<Ripples | null>;
+    isLoading: boolean;
+    error: unknown;
+};

package/{dist/types → type}/customHooks/useTimeId.d.ts

@@ -1,19 +1,23 @@
-/**************************************
+/**
+ * @license MIT
+ * enr@type/customHooks/useTimeId.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**
  *
  * ### 导出一个使用 `useRef` 创建的 `NodeJS.Timeout`
  *
  * 该数值在组件卸载时会自动调用 `clearTimeout` 清理
  *
  * @version 0.0.3
- * @see   https://lmssee.com/oops-ui/use-time-id
+ * @see   https://earthnut.dev/custom-hooks/use-time-id
  * @example
  *
  * 使用：
  *
  * ```ts
- *  import { useTimeId } from 'oops-ui/useTimeId';
- *  // 也可以全量导入
- *  // import { useTimeId } from 'oops-ui';
+ *  // import { useTimeId } from 'earthnut';
  *  ...
  *  const timeoutId = useTimeId();
  *
@@ -42,5 +46,5 @@
  *
  * 根本就不用引入这个自定义 `hook` , 哈哈哈哈哈
  *
- **************************************/
+ */
 export declare function useTimeId(): import("react").RefObject<NodeJS.Timeout | undefined>;

package/type/dog.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * enr@type/dog.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+/**  开发环境执行，该方法在 env === 'production' 时通过 babel 和 webpack 过滤移除  */
+export declare const dog: import("@qqi/log").DevLog;

package/type/index.client.d.ts

@@ -0,0 +1,20 @@
+/**
+ * @license MIT
+ * enr@type/index.client.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export { useLazyRipples } from './customHooks/useRipples/use-lazy-ripple';
+export { BackgroundRipple, LazyBackgroundRipple } from './components/ripples';
+export { useTimeId } from './customHooks/useTimeId';
+export { useAnimationFrame } from './customHooks/useAnimationFrame';
+export type { UseAnimationFrameResult, AnimationFrameOption, } from './customHooks/useAnimationFrame';
+export { useInputIsComposing } from './customHooks/useInputIsComposing';
+export { useRipples } from './customHooks/useRipples';
+export type { Ripples, BackgroundRipplesProps, RipplesOptions, RippleImgUrl, } from './customHooks/useRipples';
+export type { LayoutProps, LayoutSideBarProps, LayoutHeaderProps, LayoutFooterProps, } from './components/layout';
+export { Image, Image as EnImage } from './components/image';
+export type { EnImageProps } from './components/image';
+export { useColorMode, ThemeColorModeProvider } from './components/ThemeContext';
+export type { ColorMode, ThemeContextType, ThemeColorModeProviderProps, } from './components/ThemeContext/types';
+export { Switch, Switch as EnSwitch } from './components/switch';

package/type/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * enr@type/index.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export * from './index.client';
+export * from './index.server';

package/type/index.server.d.ts

@@ -0,0 +1,8 @@
+/**
+ * @license MIT
+ * enr@type/index.server.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export { _en, _en as enc, _en as en } from './customHooks/use-xcn';
+export { Layout, LayoutContent, LayoutFooter, LayoutHeader, LayoutSideBar, EnLayout, EnLayoutContent, EnLayoutFooter, EnLayoutHeader, EnLayoutSideBar, } from './components/layout';

package/type/storage/main-logic .d.ts

@@ -0,0 +1,26 @@
+/**
+ * @license MIT
+ * enr@type/storage/main-logic .d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+declare function set(key: string, value: unknown): void;
+declare function get<T>(key: string): T;
+declare function getAndDel<T = boolean>(key: string): T;
+declare function del(key: string): void;
+declare function clear(): void;
+declare function setSession(key: string, value: unknown): void;
+declare function getSession<T>(key: string): T;
+declare function delSession(key: string): void;
+export { del as delStorage, set as setStorage, get as getStorage, getAndDel as getStorageAndDel, clear as clearStorage, setSession as setSessionStorage, getSession as getSessionStorage, delSession as delSessionStorage, };
+declare const storageMainLogic: {
+    del: typeof del;
+    set: typeof set;
+    get: typeof get;
+    getAndDel: typeof getAndDel;
+    clear: typeof clear;
+    setSession: typeof setSession;
+    getSession: typeof getSession;
+    delSession: typeof delSession;
+};
+export { storageMainLogic };

package/type/storage/storage-store.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @license MIT
+ * enr@type/storage/storage-store.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+import { ColorMode } from 'components/ThemeContext/types';
+/**  storage 的数据仓库  */
+export declare const storageStore: {
+    /**  获取本地的数据中的主题值  */
+    theme: ColorMode | "";
+    /**  获取本地储存的 token  */
+    token: string;
+};

package/type/utilities/cookie.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @license MIT
+ * enr@type/utilities/cookie.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+export declare const manageCookie: {
+    getItem(keyItem: string): string | null;
+    setItem(option: {
+        keyItem: string;
+        value: string;
+        end?: string | number | Date;
+        path?: string;
+        domain?: string;
+        secure?: string;
+    }): boolean;
+    deleteItem(key: string, path?: string, domain?: string): boolean;
+    /**  校验当前 key 是否存在 */
+    exist(key: string): boolean;
+    keys(): string[];
+};

package/type/utilities/sys.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @license MIT
+ * enr@type/utilities/sys.d.ts 
+ * Copyright (c) 2025 earthnut.dev
+ * 请在项目根参看详细许可证明
+ */
+declare class SysInfo {
+    #private;
+    /**
+     * 设备振动
+     **/
+    vibrate(): void;
+    /**
+     * 分享网站
+     * @param [url='https://letmiseesee.pages.dev'] 网页地址 默认值 https://letmiseesee.pages.dev
+     * @param [text='']  text  文本
+     * @param [title='随笔记余生']  title  网站标题，缺省值
+     * @description
+     **/
+    share(url?: string, text?: string, title?: string): void;
+    /**
+     * 当前是否为手机设备
+     **/
+    isPhone(): boolean;
+    /**
+     * 当前设备是否为小平设备
+     **/
+    get isSmallScreen(): 'small' | 'middle' | 'large';
+    /**
+     * 是否为暗黑模式
+     **/
+    get isDark(): boolean;
+    /**
+     * 设备当前的旋转状态
+     *
+     * 只返回是否旋转
+     **/
+    get isOrientation(): boolean;
+}
+export declare const sysInfo: SysInfo;
+export {};