reykit 1.0.105 → 1.0.106

package/dist/src/base.d.ts

@@ -0,0 +1,15 @@
+/**
+ * @Time    : 2026-03-11
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Base methods.
+ */
+export type Key<T> = keyof T;
+export type Value<T> = T[keyof T];
+export type KeyByValue<T, V> = {
+    [K in keyof T]: T[K] extends V ? K : never;
+}[keyof T];
+/**
+ * Start debug CSS style, need to import 'reykit/debug' CSS style first.
+ */
+export declare function debugCss(): void;

package/dist/src/components/Breadcrumb.d.ts

@@ -0,0 +1,18 @@
+/**
+ * @Time    : 2026-03-27
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Breadcrumb components.
+ */
+export type BreadcrumbDict = Record<string, {
+    label: string;
+    href?: string;
+}[]>;
+/**
+ * Breadcrumb components.
+ *
+ * @param props.dict - Breadcrumb data dictionary.
+ */
+export declare function Breadcrumb({ dict }: {
+    dict: BreadcrumbDict;
+}): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Button.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode, ComponentProps, MouseEvent } from 'react';
+/**
+ * Button component of cycle display children.
+ *
+ * @param props.childrens - Children array.
+ * @param props.handleCycle - Handle cycle.
+ */
+export declare function CycleButton({ childrens, handleCycle, onClick, ...props }: {
+    childrens: ReactNode[];
+    handleCycle: (index: number) => any | Promise<any>;
+    data: {
+        children: ReactNode;
+        handleClick: (event: MouseEvent<HTMLButtonElement>) => void;
+    }[];
+} & ComponentProps<'button'>): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Form.d.ts

@@ -0,0 +1,11 @@
+import { ComponentProps } from 'react';
+/**
+ * Form component of prevent access link.
+ *
+ * @param props.handleFormData - Handle submited form data.
+ * @param props.link - Access router link.
+ */
+export declare function Form({ handleFormData, link, onSubmit, ...props }: {
+    handleFormData?: (formData: FormData) => any | Promise<any>;
+    link?: string;
+} & ComponentProps<'form'>): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Loading/Loading.d.ts

@@ -0,0 +1,15 @@
+import { ReactNode } from 'react';
+type LoadingContextParams = {
+    isLoading: boolean;
+    setIsLoading: (value: boolean) => void;
+};
+export declare const LoadingContext: import('react').Context<LoadingContextParams | null>;
+/**
+ * Loading component of display rotate icon.
+ *
+ * @param props.children - The node tree of the mounting context.
+ */
+export declare function Loading({ children }: {
+    children: ReactNode;
+}): import("react/jsx-runtime").JSX.Element;
+export {};

package/dist/src/components/Loading/uesLoading.d.ts

@@ -0,0 +1,19 @@
+/**
+ * @Time    : 2026-03-25
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Hook of loading components.
+ */
+/**
+ * Hook of get loading component status parameters.
+ *
+ * @returns Status parameters.
+ *     - `isLoading` : Loading status.
+ *     - `setIsLoading` : Set loading status.
+ *     - `withLoading` : Execute a function in the context.
+ */
+export declare function useLoading(): {
+    withLoading: <T, Args extends any[]>(fn: (...args: Args) => T | Promise<T>, ...args: Args) => Promise<T>;
+    isLoading: boolean;
+    setIsLoading: (value: boolean) => void;
+};

package/dist/src/components/Notice.d.ts

@@ -0,0 +1,11 @@
+import { ReactNode } from 'react';
+import { ToasterProps } from 'sonner';
+export { toast as notice } from 'sonner';
+/**
+ * Top banner notice component.
+ *
+ * @param props.children - The node tree of the mounting context.
+ */
+export declare function Notice({ children, position, richColors, toastOptions, ...props }: {
+    children: ReactNode;
+} & ToasterProps): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/Toggle.d.ts

@@ -0,0 +1,23 @@
+import { ReactNode, ComponentProps } from 'react';
+/**
+ * Toggle component of with icon.
+ *
+ * @param props.openIcon - Open icon.
+ * @param props.closeIcon - Close icon.
+ * @param props.tooltip - Tooltip text.
+ * @param props.tooltipSide - Tooltip text popup side.
+ * @param props.rotate - Whether to use rotating icon animation.
+ * @param props.open - Open state value.
+ * @param props.onChangeOpen - Open callback function.
+ * @param props.defaultOpen - Default open state.
+ */
+export declare function IconToggle({ openIcon, closeIcon, tooltip, tooltipSide, rotate, open, onChangeOpen, defaultOpen, onClick, className, ...props }: {
+    openIcon: ReactNode;
+    closeIcon: ReactNode;
+    tooltip?: string;
+    tooltipSide?: 'top' | 'bottom' | 'left' | 'right';
+    rotate?: boolean;
+    open?: boolean;
+    onChangeOpen?: (nextOpen: boolean) => any | Promise<any>;
+    defaultOpen?: boolean;
+} & ComponentProps<'button'>): import("react/jsx-runtime").JSX.Element;

package/dist/src/components/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * @Time    : 2026-03-11
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Component index file.
+ */
+export { Breadcrumb } from './Breadcrumb';
+export { CycleButton } from './Button';
+export { Form } from './Form';
+export { Loading } from './Loading/Loading';
+export { useLoading } from './Loading/uesLoading';
+export { Notice, notice } from './Notice';
+export { IconToggle } from './Toggle';

package/dist/src/data.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @Time    : 2026-03-17
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Data methods.
+ */
+export declare function range(stop: number): Generator<number>;
+export declare function range(start: number, stop: number, step?: number): Generator<number>;
+export declare function rangeArr(stop: number): number[];
+export declare function rangeArr(start: number, stop: number, step?: number): number[];

package/dist/src/index.d.ts

@@ -0,0 +1,19 @@
+import * as component from './components';
+import * as base from './base';
+import * as data from './data';
+import * as net from './net';
+import * as re from './re';
+import * as react from './react';
+import * as twc from './twc';
+import * as window from './window';
+declare const _default: {
+    component: typeof component;
+    base: typeof base;
+    data: typeof data;
+    net: typeof net;
+    re: typeof re;
+    react: typeof react;
+    twc: typeof twc;
+    window: typeof window;
+};
+export default _default;

package/dist/src/net.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @Time    : 2026-03-11
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Network methods.
+ */
+/**
+ * Send request.
+ *
+ * @param url - Request URL.
+ * @param option - Request option.
+ * @param option.params - Request URL add parameters.
+ * @param option.body - Request body data.
+ *     - `URLSearchParams` : Form data. Automatic set `Content-Type` to `application/x-www-form-urlencoded`.
+ *     - `FormData` : Multi form data. Automatic set `Content-Type` to `multipart/form-data`.
+ *     - `File` : `file` item of multi form data. Automatic set `Content-Type` to attribute `type` value.
+ *     - `Blob` : Bytes data. Automatic set `Content-Type` to attribute `type` value.
+ *     - `Record<string, any> | string` : JSON data. Automatic set `Content-Type` to `application/json`.
+ * @param option.headers - Request header data.
+ * @param option.method - Request method.
+ *     - `undefined` : Automatic judge. When parameter `data` not has value, then is `get`, otherwise is `post`.
+ * @param option.check - Whether to throw an error if the response is not in the 200–299 range.
+ *     Note: `Error.message` is response body string, `Error.cause` is `Response` instance.
+ *     - `undefined` : False.
+ */
+export declare function request(url: string, option?: {
+    params?: Record<string, string | number | boolean>;
+    body?: URLSearchParams | File | FormData | Blob | Record<string, any> | string;
+    headers?: Record<string, string | number | boolean>;
+    method?: 'get' | 'post' | 'put' | 'patch' | 'delete' | 'options' | 'head';
+    check?: boolean;
+}): Promise<Response>;

package/dist/src/re.d.ts

@@ -0,0 +1,11 @@
+/**
+ * @Time    : 2026-03-11
+ * @Author  : Rey
+ * @Contact : reyxbo@163.com
+ * @Explain : Regular expression methods.
+ */
+export declare const PATTERN_IP: RegExp;
+export declare const PATTERN_URL: RegExp;
+export declare const PATTERN_EMAIL: RegExp;
+export declare const PATTERN_PHONE: RegExp;
+export declare const PATTERN_CN: RegExp;

package/dist/src/react.d.ts

@@ -0,0 +1,46 @@
+import { ReactNode } from 'react';
+/**
+ * Render react note.
+ * Note: `react` and `react-dom` packages version must be `19.2.4`.
+ *
+ * @param app - React note.
+ * @param elementId - Render HTML element ID.
+ */
+export declare function renderReact(app: ReactNode, elementId?: string): void;
+/**
+ * Hook of toggle.
+ *
+ * @param array - Array.
+ * @param loop - Whether to loop count.
+ * @returns Returns a stateful open value, and a function to automatic count it.
+ */
+export declare function useOpen(defaultOpen?: boolean): [boolean, (open?: boolean) => void];
+/**
+ * Hook of count number.
+ *
+ * @param start - Start number.
+ * @param step - Count step.
+ * @param stop - Stop number.
+ * @param loop - Whether to loop count.
+ * @returns Returns a stateful count value, and a function to automatic count it.
+ */
+export declare function useCount(start?: number, step?: number, stop?: number, loop?: boolean): [number, () => void];
+/**
+ * Hook of count array index.
+ *
+ * @param array - Array.
+ * @param loop - Whether to loop count.
+ * @returns Returns a stateful index value, and a function to automatic count it.
+ */
+export declare function useIndex(array: any[], loop?: boolean): [number, () => void];
+/**
+ * Force update render.
+ */
+export declare function useRender(): () => void;
+/**
+ * Whether is mobile.
+ *
+ * @returns Judgement.
+ */
+export declare function useIsMobile(): boolean;
+export declare function useValueByMobile<Value, MobileValue>(value: Value, mobileValue: MobileValue): Value | MobileValue;

package/dist/src/twc.d.ts

@@ -0,0 +1,8 @@
+import { ClassValue } from 'clsx';
+/**
+ * Merge TailwindCSS class style string array.
+ *
+ * @param inputs - TailwindCSS class style string array.
+ * @returns Merged string.
+ */
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/src/window.d.ts

@@ -0,0 +1,67 @@
+import { Key, Value, KeyByValue } from './base';
+/**
+ * Manage local storage data.
+ */
+export declare class Storager<Data extends Record<string, any>> {
+    name: string;
+    /**
+     * Build instance.
+     *
+     * @param name - Local storage key.
+     */
+    constructor(name: string);
+    /**
+     * Get all data.
+     *
+     * @returns All data.
+     */
+    get data(): Data;
+    /**
+     * Get all keys.
+     *
+     * @returns All keys.
+     */
+    get keys(): Key<Data>[];
+    /**
+     * Get all values.
+     *
+     * @returns All values.
+     */
+    get values(): Value<Data>[];
+    /**
+     * Update data.
+     *
+     * @param data - New data.
+     */
+    update(data: Partial<Data>): void;
+    /**
+     * Clear data.
+     */
+    clear(): void;
+    /**
+     * Get a item value.
+     *
+     * @param key - Item key.
+     * @returns Item value.
+     */
+    get<K extends keyof Data>(key: K): Data[K];
+    /**
+     * Set a item.
+     *
+     * @param key - Item key.
+     * @param value - Item value.
+     */
+    set<K extends keyof Data>(key: K, value: Data[K]): void;
+    /**
+     * Delete a item.
+     *
+     * @param key - Item key.
+     */
+    del<K extends keyof Data>(key: K): void;
+    /**
+     * Toggle boolean value.
+     *
+     * @param key - Item key.
+     */
+    toggle<K extends KeyByValue<Data, boolean>>(key: K): void;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "reykit",
-    "version": "1.0.105",
+    "version": "1.0.106",
     "description": "Kit method set.",
     "author": "reyxbo",
     "keywords": [
@@ -22,7 +22,7 @@
     ],
     "type": "module",
     "main": "./dist/index.js",
-    "types": "./dist/index.d.ts",
+    "types": "./dist/src/index.d.ts",
     "exports": {
         ".": {
             "default": "./dist/index.js"

package/dist/index.d.ts

@@ -1 +0,0 @@
-export { }