@ldkj/web-ui 0.17.0 → 0.19.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 ldkj
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 ldkj
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/components/interact/alert/Alert.d.ts

@@ -5,5 +5,19 @@ export type AlertProps = React.HTMLAttributes<HTMLDivElement> & {
     variant?: AlertVariant;
     title?: React.ReactNode;
     description?: React.ReactNode;
+    /** Custom leading icon. Pass showIcon to use the built-in tone marker. */
+    icon?: React.ReactNode;
+    /** Whether to render the leading icon area. */
+    showIcon?: boolean;
+    /** Optional trailing action, such as a retry button or detail link. */
+    action?: React.ReactNode;
+    /** Render a close button. */
+    closable?: boolean;
+    /** Controlled visibility. */
+    open?: boolean;
+    /** Fired after the close button is clicked. */
+    onClose?: () => void;
+    /** Controlled visibility callback. */
+    onOpenChange?: (open: boolean) => void;
 };
-export declare function Alert(props: AlertProps): import("react/jsx-runtime").JSX.Element;
+export declare function Alert(props: AlertProps): import("react/jsx-runtime").JSX.Element | null;

package/components/interact/drawer/Drawer.d.ts

@@ -1,11 +1,29 @@
 import * as React from "react";
-export type DrawerProps = {
+export type DrawerPlacement = "left" | "right" | "top" | "bottom";
+export type DrawerProps = React.HTMLAttributes<HTMLDivElement> & {
     open: boolean;
     title?: React.ReactNode;
     width?: number | string;
+    height?: number | string;
+    placement?: DrawerPlacement;
     className?: string;
     class?: string;
+    overlayClassName?: string;
+    bodyClassName?: string;
+    footer?: React.ReactNode;
     children?: React.ReactNode;
     onOpenChange?: (open: boolean) => void;
+    /** Enables slide/fade transitions. Set false when a test or host app needs instant state changes. */
+    animated?: boolean;
+    /** Transition duration in ms. */
+    animationDuration?: number;
+    /** Locks document scrolling while the drawer is open. */
+    lockScroll?: boolean;
+    /** Close when clicking the mask. */
+    maskClosable?: boolean;
+    /** Close when pressing Escape. */
+    closeOnEsc?: boolean;
+    /** Keep content mounted after close. */
+    destroyOnClose?: boolean;
 };
 export declare function Drawer(props: DrawerProps): import("react/jsx-runtime").JSX.Element | null;

package/components/interact/loading/Loading.d.ts

@@ -1,3 +1,19 @@
-export declare function Loading({ text }: {
-    text?: string;
-}): import("react/jsx-runtime").JSX.Element;
+import * as React from "react";
+import { type SpinProps } from "@/components/interact/spin";
+export type LoadingVariant = "inline" | "block" | "overlay" | "fullscreen";
+export type LoadingProps = React.HTMLAttributes<HTMLDivElement> & {
+    /** Loading text. Set to null to hide text while keeping the spinner. */
+    text?: React.ReactNode;
+    /** Layout mode for inline hints, blocks, overlays, or full-screen masks. */
+    variant?: LoadingVariant;
+    /** Spinner size. Numbers are treated as px. */
+    size?: SpinProps["size"];
+    /** Spinner tone. */
+    tone?: SpinProps["tone"];
+    /** Set to false to hide loading state without unmounting wrapped children. */
+    spinning?: boolean;
+    /** Delay in ms before showing the loading indicator. */
+    delay?: number;
+    class?: string;
+};
+export declare function Loading(props: LoadingProps): import("react/jsx-runtime").JSX.Element | null;

package/components/interact/notification/Notification.d.ts

@@ -1,6 +1,21 @@
+import type { NotificationOffset, NotificationOptions, NotificationPlacement } from "./types";
+export interface NotificationFacadeConfig {
+    placement?: NotificationPlacement;
+    duration?: number;
+    closable?: boolean;
+    offset?: NotificationOffset;
+}
+/**
+ * 全局 notification facade。请先挂载 NotificationProvider，再在任意业务模块调用。
+ */
 export declare const notification: {
-    info(message: string): string;
-    success(message: string): string;
-    warn(message: string): string;
-    error(message: string): string;
+    open(options: NotificationOptions): string;
+    info(options: NotificationOptions | string): string;
+    success(options: NotificationOptions | string): string;
+    warn(options: NotificationOptions | string): string;
+    error(options: NotificationOptions | string): string;
+    dismiss(id: string): void;
+    clear(): void;
+    config(config: NotificationFacadeConfig): void;
+    resetConfig(): void;
 };

package/components/interact/notification/NotificationProvider.d.ts

@@ -0,0 +1,27 @@
+import * as React from "react";
+import type { NotificationOffset, NotificationOptions, NotificationPlacement } from "./types";
+import "./notification.css";
+export interface NotificationProviderProps {
+    children?: React.ReactNode;
+    placement?: NotificationPlacement;
+    duration?: number;
+    queueLimit?: number;
+    offset?: NotificationOffset;
+    closable?: boolean;
+}
+export declare function NotificationProvider(props: NotificationProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace NotificationProvider {
+    var displayName: string;
+}
+/**
+ * 获取当前 NotificationProvider 提供的通知 API。
+ */
+export declare function useNotification(): {
+    open: (options: NotificationOptions) => string;
+    info: (options: NotificationOptions | string) => string;
+    success: (options: NotificationOptions | string) => string;
+    warn: (options: NotificationOptions | string) => string;
+    error: (options: NotificationOptions | string) => string;
+    dismiss: (id: string) => void;
+    clear: () => void;
+};

package/components/interact/notification/bridge.d.ts

@@ -0,0 +1,3 @@
+import type { NotificationContextValue } from "./types";
+export declare function setNotificationBridge(next: NotificationContextValue | null): void;
+export declare function getNotificationBridge(): NotificationContextValue | null;

package/components/interact/notification/index.d.ts

@@ -1 +1,3 @@
-export * from './Notification';
+export * from "./Notification";
+export * from "./NotificationProvider";
+export * from "./types";

package/components/interact/notification/types.d.ts

@@ -0,0 +1,39 @@
+import type * as React from "react";
+export type NotificationType = "info" | "success" | "warn" | "error";
+export type NotificationPlacement = "rightTop" | "rightBottom" | "leftTop" | "leftBottom" | "center";
+export type NotificationOffset = number | {
+    top?: number;
+    right?: number;
+    bottom?: number;
+    left?: number;
+};
+export type NotificationCustomSvg = React.ComponentType<React.SVGProps<SVGSVGElement> & {
+    title?: string;
+}>;
+export type NotificationIconOption = string | {
+    svg?: NotificationCustomSvg;
+    src?: string;
+};
+export interface NotificationOptions {
+    id?: string;
+    message: React.ReactNode;
+    description?: React.ReactNode;
+    content?: React.ReactNode;
+    actions?: React.ReactNode;
+    duration?: number;
+    placement?: NotificationPlacement;
+    offset?: NotificationOffset;
+    closable?: boolean;
+    icon?: NotificationIconOption;
+    iconColor?: string;
+    onClose?: () => void;
+}
+export interface NotificationCreateInput extends NotificationOptions {
+    type?: NotificationType;
+}
+export type NotificationShortcutInput = string | NotificationOptions;
+export interface NotificationContextValue {
+    push: (input: NotificationCreateInput) => string;
+    dismiss: (id: string) => void;
+    clear: () => void;
+}

package/components/interact/progress/Progress.d.ts

@@ -1,8 +1,17 @@
 import * as React from "react";
+export type ProgressType = "line" | "circle";
+export type ProgressStatus = "normal" | "success" | "warning" | "exception";
 export type ProgressProps = React.HTMLAttributes<HTMLDivElement> & {
     value?: number;
     max?: number;
     showInfo?: boolean;
+    type?: ProgressType;
+    status?: ProgressStatus;
+    size?: number;
+    strokeWidth?: number;
+    strokeColor?: string;
+    trailColor?: string;
+    format?: (percent: number, value: number, max: number) => React.ReactNode;
     class?: string;
 };
 export declare function Progress(props: ProgressProps): import("react/jsx-runtime").JSX.Element;

package/components/interact/spin/Spin.d.ts

@@ -1,6 +1,16 @@
 import * as React from "react";
+export type SpinTone = "primary" | "muted" | "success" | "warning" | "danger";
 export type SpinProps = React.HTMLAttributes<HTMLSpanElement> & {
-    size?: number;
+    /** Spinner size. Numbers are treated as px. */
+    size?: number | string;
+    /** Ring stroke width. Numbers are treated as px. */
+    strokeWidth?: number | string;
+    /** Color tone for the active ring segment. */
+    tone?: SpinTone;
+    /** Accessible label announced by screen readers. */
+    label?: string;
+    /** Set to false to suppress the spinner without branching in user code. */
+    spinning?: boolean;
     class?: string;
 };
-export declare function Spin(props: SpinProps): import("react/jsx-runtime").JSX.Element;
+export declare function Spin(props: SpinProps): import("react/jsx-runtime").JSX.Element | null;