@ldkj/web-ui 0.18.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/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;