@_tc/template-core 0.0.1-bate.9 → 0.0.2

package/fe/packages/ui/react/components/ImagePreview/ImagePreview.js

@@ -1,9 +1,12 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
 import { ArrowLeft, ArrowRight, FlipHorizontal, FlipVertical, RefreshCw, RotateCcw, RotateCw, X, ZoomIn, ZoomOut, } from 'lucide-react';
+import { useI18n } from '../../i18n';
 import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { createPortal } from 'react-dom';
+import { Button } from '../Button';
 const clamp = (value, min, max) => Math.min(max, Math.max(min, value));
 function PreviewCore({ images, initialIndex, onClose }) {
+    const t = useI18n();
     const [index, setIndex] = useState(initialIndex);
     const [scale, _setScale] = useState(1);
     const scaleRef = useRef(scale);
@@ -98,13 +101,13 @@ function PreviewCore({ images, initialIndex, onClose }) {
     }, [rotation, scale, flipX, flipY, position]);
     if (!hasImages)
         return null;
-    const content = (_jsxs("div", { className: "fixed inset-0 z-[1100] bg-black/40 text-white", onClick: onClose, children: [_jsx("button", { type: "button", onClick: onClose, className: "absolute right-6 top-6 p-2 rounded-full bg-black/70 hover:bg-black/80 transition-colors z-10", "aria-label": "\u5173\u95ED\u9884\u89C8", children: _jsx(X, { size: 20 }) }), images.length > 1 && (_jsxs(_Fragment, { children: [_jsx("button", { type: "button", onClick: (e) => {
+    const content = (_jsxs("div", { className: "tc-ui-image-preview fixed inset-0 z-[1100] bg-black/40 text-white", onClick: onClose, children: [_jsx(Button, { variant: "text", type: "button", onClick: onClose, className: "absolute right-6 top-6 p-2 rounded-full bg-black/70 hover:bg-black/80 transition-colors z-10", "aria-label": t('components.imagePreview.closePreview'), children: _jsx(X, { size: 20 }) }), images.length > 1 && (_jsxs(_Fragment, { children: [_jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             toPrev();
-                        }, className: "absolute left-4 top-1/2 -translate-y-1/2 p-3 rounded-full bg-black/70 hover:bg-black/80 transition-colors z-10", "aria-label": "\u4E0A\u4E00\u5F20", children: _jsx(ArrowLeft, { size: 20 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "absolute left-4 top-1/2 -translate-y-1/2 p-3 rounded-full bg-black/70 hover:bg-black/80 transition-colors z-10", "aria-label": t('components.imagePreview.previousImage'), children: _jsx(ArrowLeft, { size: 20 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             toNext();
-                        }, className: "absolute right-4 top-1/2 -translate-y-1/2 p-3 rounded-full bg-black/70 hover:bg-black/80 transition-colors z-10", "aria-label": "\u4E0B\u4E00\u5F20", children: _jsx(ArrowRight, { size: 20 }) })] })), _jsx("div", { className: "absolute inset-0 flex items-center justify-center overflow-hidden", onClick: (e) => e.stopPropagation(), onWheel: (e) => {
+                        }, className: "absolute right-4 top-1/2 -translate-y-1/2 p-3 rounded-full bg-black/70 hover:bg-black/80 transition-colors z-10", "aria-label": t('components.imagePreview.nextImage'), children: _jsx(ArrowRight, { size: 20 }) })] })), _jsx("div", { className: "absolute inset-0 flex items-center justify-center overflow-hidden", onClick: (e) => e.stopPropagation(), onWheel: (e) => {
                     e.preventDefault();
                     if (e.deltaY < 0) {
                         zoomIn();
@@ -112,13 +115,13 @@ function PreviewCore({ images, initialIndex, onClose }) {
                     else {
                         zoomOut();
                     }
-                }, onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, onMouseUp: handleMouseUp, onMouseLeave: handleMouseUp, style: { cursor: isDragging ? 'grabbing' : scale > 1 ? 'grab' : 'default' }, children: _jsx("div", { className: "relative max-h-[85vh] max-w-[90vw]", children: _jsx("img", { ref: imgRef, src: currentImage, alt: "", draggable: false, className: " select-none max-h-[85vh] max-w-[90vw] absolute left-1/2 top-1/2 origin-center" }) }) }), _jsxs("div", { className: "absolute bottom-6 left-1/2 -translate-x-1/2 flex items-center gap-2 bg-black/70 backdrop-blur px-3 py-2 rounded-lg", children: [_jsx("button", { type: "button", onClick: (e) => {
+                }, onMouseDown: handleMouseDown, onMouseMove: handleMouseMove, onMouseUp: handleMouseUp, onMouseLeave: handleMouseUp, style: { cursor: isDragging ? 'grabbing' : scale > 1 ? 'grab' : 'default' }, children: _jsx("div", { className: "relative max-h-[85vh] max-w-[90vw]", children: _jsx("img", { ref: imgRef, src: currentImage, alt: "", draggable: false, className: " select-none max-h-[85vh] max-w-[90vw] absolute left-1/2 top-1/2 origin-center" }) }) }), _jsxs("div", { className: "absolute bottom-6 left-1/2 -translate-x-1/2 flex items-center gap-2 bg-black/70 backdrop-blur px-3 py-2 rounded-lg", children: [_jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             zoomOut();
-                        }, className: "flex items-center gap-1 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u7F29\u5C0F", children: _jsx(ZoomOut, { size: 16 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-1 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.zoomOut'), children: _jsx(ZoomOut, { size: 16 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             zoomIn();
-                        }, className: "flex items-center gap-1 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u653E\u5927", children: _jsx(ZoomIn, { size: 16 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-1 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.zoomIn'), children: _jsx(ZoomIn, { size: 16 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             if (!imgRef.current)
                                 return;
@@ -140,22 +143,22 @@ function PreviewCore({ images, initialIndex, onClose }) {
                                 setScale(lastScaleBeforeNatural.current);
                                 lastScaleBeforeNatural.current = null;
                             }
-                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "1:1", children: "1:1" }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "1:1", children: "1:1" }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             reset();
-                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u91CD\u7F6E", children: _jsx(RefreshCw, { size: 16 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.reset'), children: _jsx(RefreshCw, { size: 16 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             rotateLeft();
-                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u5DE6\u65CB\u8F6C", children: _jsx(RotateCcw, { size: 16 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.rotateLeft'), children: _jsx(RotateCcw, { size: 16 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             rotateRight();
-                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u53F3\u65CB\u8F6C", children: _jsx(RotateCw, { size: 16 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.rotateRight'), children: _jsx(RotateCw, { size: 16 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             setFlipX((prev) => !prev);
-                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u5DE6\u53F3\u955C\u50CF", children: _jsx(FlipHorizontal, { size: 16 }) }), _jsx("button", { type: "button", onClick: (e) => {
+                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.flipHorizontal'), children: _jsx(FlipHorizontal, { size: 16 }) }), _jsx(Button, { variant: "text", type: "button", onClick: (e) => {
                             e.stopPropagation();
                             setFlipY((prev) => !prev);
-                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": "\u4E0A\u4E0B\u955C\u50CF", children: _jsx(FlipVertical, { size: 16 }) })] })] }));
+                        }, className: "flex items-center gap-2 px-3 py-2 rounded-md hover:bg-white/15 text-sm", "aria-label": t('components.imagePreview.flipVertical'), children: _jsx(FlipVertical, { size: 16 }) })] })] }));
     return createPortal(content, document.body);
 }
 export function ImagePreviewController({ open, images, initialIndex = 0, onClose }) {

package/fe/packages/ui/react/components/ImagePreview/PreviewImage.js

@@ -1,7 +1,10 @@
 import { jsx as _jsx, Fragment as _Fragment, jsxs as _jsxs } from "react/jsx-runtime";
+import { useI18n } from '../../i18n';
 import { useMemo, useState } from 'react';
+import { Button } from '../Button';
 import { ImagePreviewController } from './ImagePreview';
 export function PreviewImage(props) {
+    const t = useI18n();
     const { onClose, images, thumbSize = 80, direction = 'horizontal', ...ext } = props;
     const [open, setOpen] = useState(false);
     const [currentIndex, setCurrentIndex] = useState(ext.initialIndex ?? 0);
@@ -15,10 +18,10 @@ export function PreviewImage(props) {
     }, [thumbSize]);
     if (!images?.length)
         return null;
-    return (_jsxs(_Fragment, { children: [_jsx("div", { className: `flex gap-2 ${direction === 'vertical' ? 'flex-col' : ''}`, children: images.map((src, idx) => (_jsx("button", { type: "button", className: `relative aspect-square overflow-hidden rounded border border-border ${sizeClass}`, style: sizeStyle, onClick: () => {
+    return (_jsxs(_Fragment, { children: [_jsx("div", { className: `flex gap-2 ${direction === 'vertical' ? 'flex-col' : ''}`, children: images.map((src, idx) => (_jsx(Button, { variant: "text", type: "button", className: `relative aspect-square overflow-hidden rounded border border-border ${sizeClass}`, style: sizeStyle, onClick: () => {
                         setCurrentIndex(idx);
                         setOpen(true);
-                    }, "aria-label": `预览第${idx + 1}张`, children: _jsx("img", { src: src, alt: "", className: "h-full w-full object-cover" }) }, src + idx))) }), _jsx(ImagePreviewController, { ...ext, images: images, initialIndex: currentIndex, open: open, onClose: () => {
+                    }, "aria-label": t('components.imagePreview.previewImage', { index: idx + 1 }), children: _jsx("img", { src: src, alt: "", className: "h-full w-full object-cover" }) }, src + idx))) }), _jsx(ImagePreviewController, { ...ext, images: images, initialIndex: currentIndex, open: open, onClose: () => {
                     setOpen(false);
                     onClose?.();
                 } })] }));

package/fe/packages/ui/react/components/Input/Input.d.ts

@@ -17,8 +17,10 @@ export type InputProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'value' | '
     };
     /** 输入框内部右侧按钮 */
     addonAfter?: ReactNode;
+    /** 原生 input 节点的自定义 className */
+    inputClassName?: string;
 };
-declare const Input: import("react").ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "defaultValue" | "onChange" | "value"> & {
+declare const Input: import("react").ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "defaultValue" | "onChange"> & {
     value?: string;
     /**
      *
@@ -36,6 +38,8 @@ declare const Input: import("react").ForwardRefExoticComponent<Omit<InputHTMLAtt
     };
     /** 输入框内部右侧按钮 */
     addonAfter?: ReactNode;
+    /** 原生 input 节点的自定义 className */
+    inputClassName?: string;
 } & import("react").RefAttributes<HTMLInputElement>>;
 export { Input };
 //# sourceMappingURL=Input.d.ts.map

package/fe/packages/ui/react/components/Input/Input.js

@@ -3,21 +3,22 @@ import { cn } from '../../lib/utils';
 import { X } from 'lucide-react';
 import { forwardRef, useCallback, useMemo } from 'react';
 import { useInputController } from '../hooks/useInputController';
-const Input = forwardRef(({ className, type, value: controlledValue, onChange, defaultValue, allowClear, disabled, addonAfter, ...props }, ref) => {
+const Input = forwardRef(({ className, inputClassName, type, value: controlledValue, onChange, defaultValue, allowClear, disabled, addonAfter, ...props }, ref) => {
     const { setInternalValue, setIsFocused, setRefs, controllerRef, isControlledRef, isFocused, value, hasValue, } = useInputController({
         defaultValue,
         controlledValue,
         ref,
     });
+    const isFileInput = type === 'file';
     // 在change恒定时 不重复生成 fn
     // isControlledRef setInternalValue 都是不会变的值
     const handleChange = useCallback((e) => {
         const newValue = e.target.value;
-        if (!isControlledRef.current) {
+        if (!isFileInput && !isControlledRef.current) {
             setInternalValue(newValue);
         }
         onChange?.(newValue, e);
-    }, [isControlledRef, onChange, setInternalValue]);
+    }, [isFileInput, isControlledRef, onChange, setInternalValue]);
     const handleClear = useCallback((e) => {
         e.preventDefault();
         e.stopPropagation();
@@ -44,7 +45,7 @@ const Input = forwardRef(({ className, type, value: controlledValue, onChange, d
         return undefined;
     }, [allowClear]);
     const showClearIcon = hasValue && clearIcon && !disabled;
-    return (_jsxs("div", { className: "relative w-full", children: [_jsx("input", { type: type, ref: setRefs, value: value, onChange: handleChange, className: cn('flex w-full rounded-lg px-4 py-3 text-sm', 'border transition-colors duration-200', 'placeholder:text-muted-foreground', 'focus:outline-none', showClearIcon && 'pr-10', addonAfter && 'pr-12', disabled ? 'cursor-not-allowed bg-muted border-border text-muted-foreground' : 'bg-background', !disabled && !hasValue && !isFocused && 'border-border', !disabled && (hasValue || isFocused) && 'border-theme', className), onFocus: (e) => {
+    return (_jsxs("div", { className: cn('tc-ui-input relative w-full', className), children: [_jsx("input", { type: type, ref: setRefs, ...(!isFileInput && { value }), onChange: handleChange, className: cn('flex w-full rounded-lg px-4 py-3 text-sm', 'border transition-colors duration-200', 'placeholder:text-muted-foreground', 'focus:outline-none', showClearIcon && 'pr-10', addonAfter && 'pr-12', disabled ? 'cursor-not-allowed bg-muted border-border text-muted-foreground' : 'bg-background', !disabled && !hasValue && !isFocused && 'border-border', !disabled && (hasValue || isFocused) && 'border-theme', inputClassName), onFocus: (e) => {
                     if (!disabled) {
                         setIsFocused(true);
                         props.onFocus?.(e);

package/fe/packages/ui/react/components/InputNumber/InputNumber.d.ts

@@ -0,0 +1,28 @@
+import type { ChangeEvent, InputHTMLAttributes, ReactNode } from 'react';
+import { type InputNumberConstraints } from './inputNumberUtils';
+export type InputNumberProps = Omit<InputHTMLAttributes<HTMLInputElement>, 'defaultValue' | 'onChange' | 'step' | 'type' | 'value'> & InputNumberConstraints & {
+    value?: number;
+    defaultValue?: number;
+    onChange?: (value: number | undefined, e: ChangeEvent<HTMLInputElement>) => void;
+    allowClear?: boolean | {
+        clearIcon: ReactNode;
+    };
+    addonAfter?: ReactNode;
+    allowStep?: boolean;
+    /** 原生 input 节点的自定义 className */
+    inputClassName?: string;
+};
+declare const InputNumber: import("react").ForwardRefExoticComponent<Omit<InputHTMLAttributes<HTMLInputElement>, "value" | "type" | "defaultValue" | "onChange" | "step"> & InputNumberConstraints & {
+    value?: number;
+    defaultValue?: number;
+    onChange?: (value: number | undefined, e: ChangeEvent<HTMLInputElement>) => void;
+    allowClear?: boolean | {
+        clearIcon: ReactNode;
+    };
+    addonAfter?: ReactNode;
+    allowStep?: boolean;
+    /** 原生 input 节点的自定义 className */
+    inputClassName?: string;
+} & import("react").RefAttributes<HTMLInputElement>>;
+export { InputNumber };
+//# sourceMappingURL=InputNumber.d.ts.map

package/fe/packages/ui/react/components/InputNumber/InputNumber.js

@@ -0,0 +1,144 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from '../../lib/utils';
+import { ChevronDown, ChevronUp, X } from 'lucide-react';
+import { forwardRef, useCallback, useEffect, useMemo, useRef, useState } from 'react';
+import { formatNumber, isValidNumberInput, normalizeNumber, parseInputNumber, shouldSyncDisplayValue, stepValue, } from './inputNumberUtils';
+const formatDisplayValue = (value, constraints) => typeof value === 'number' ? formatNumber(value, constraints) : '';
+const getBlurValue = (rawValue) => {
+    if (rawValue === '' || rawValue === '-' || rawValue === '.' || rawValue === '-.') {
+        return undefined;
+    }
+    const normalizedRawValue = rawValue.endsWith('.') ? rawValue.slice(0, -1) : rawValue;
+    const parsedValue = Number(normalizedRawValue);
+    return Number.isFinite(parsedValue) ? parsedValue : undefined;
+};
+const InputNumber = forwardRef(({ className, inputClassName, value: controlledValue, onChange, defaultValue, allowClear, addonAfter, allowStep = false, disabled, min, max, precision, step, inputMode = 'decimal', ...props }, ref) => {
+    const constraints = useMemo(() => ({
+        min,
+        max,
+        precision,
+        step,
+    }), [max, min, precision, step]);
+    const isControlled = controlledValue !== undefined;
+    const [internalValue, setInternalValue] = useState(defaultValue);
+    const currentValue = isControlled ? controlledValue : internalValue;
+    const [isFocused, setIsFocused] = useState(false);
+    const [displayValue, setDisplayValue] = useState(() => formatDisplayValue(currentValue, constraints));
+    const inputRef = useRef(null);
+    const setRefs = useCallback((node) => {
+        inputRef.current = node;
+        if (typeof ref === 'function') {
+            ref(node);
+        }
+        else if (ref) {
+            ref.current = node;
+        }
+    }, [ref]);
+    useEffect(() => {
+        if (!shouldSyncDisplayValue({ isFocused, displayValue, currentValue })) {
+            return;
+        }
+        const nextDisplayValue = formatDisplayValue(currentValue, constraints);
+        if (nextDisplayValue !== displayValue) {
+            setDisplayValue(nextDisplayValue);
+        }
+    }, [constraints, currentValue, displayValue, isFocused]);
+    const emitChange = useCallback((nextValue, e, forceNotify = false) => {
+        if (!isControlled) {
+            setInternalValue(nextValue);
+        }
+        if (forceNotify || !Object.is(currentValue, nextValue)) {
+            onChange?.(nextValue, e);
+        }
+    }, [currentValue, isControlled, onChange]);
+    const createSyntheticChangeEvent = useCallback((value) => {
+        const target = inputRef.current;
+        if (target) {
+            target.value = value;
+        }
+        return {
+            target: { value },
+            currentTarget: { value },
+        };
+    }, []);
+    const handleChange = useCallback((e) => {
+        const nextDisplayValue = e.target.value;
+        if (!isValidNumberInput(nextDisplayValue)) {
+            return;
+        }
+        setDisplayValue(nextDisplayValue);
+        const parsedValue = parseInputNumber(nextDisplayValue);
+        if (parsedValue.kind === 'empty') {
+            emitChange(undefined, e);
+            return;
+        }
+        if (parsedValue.kind === 'number') {
+            emitChange(parsedValue.value, e);
+        }
+    }, [emitChange]);
+    const handleBlur = useCallback((e) => {
+        setIsFocused(false);
+        const nextValue = getBlurValue(displayValue);
+        if (nextValue === undefined) {
+            const syntheticEvent = createSyntheticChangeEvent('');
+            setDisplayValue('');
+            emitChange(undefined, syntheticEvent);
+            props.onBlur?.(e);
+            return;
+        }
+        const normalizedValue = normalizeNumber(nextValue, constraints);
+        const nextDisplayValue = formatDisplayValue(normalizedValue, constraints);
+        const syntheticEvent = createSyntheticChangeEvent(nextDisplayValue);
+        setDisplayValue(nextDisplayValue);
+        emitChange(normalizedValue, syntheticEvent);
+        props.onBlur?.(e);
+    }, [constraints, createSyntheticChangeEvent, displayValue, emitChange, props]);
+    const handleFocus = useCallback((e) => {
+        if (disabled) {
+            return;
+        }
+        setIsFocused(true);
+        props.onFocus?.(e);
+    }, [disabled, props]);
+    const clearIcon = useMemo(() => {
+        if (!allowClear) {
+            return undefined;
+        }
+        if (typeof allowClear === 'boolean') {
+            return (_jsx("span", { className: cn('h-5 w-5 rounded-full', 'bg-muted text-foreground', 'flex items-center justify-center', 'transition-colors hover:bg-muted/80'), children: _jsx(X, { size: 12 }) }));
+        }
+        return allowClear.clearIcon;
+    }, [allowClear]);
+    const hasValue = displayValue.length > 0;
+    const showClearIcon = hasValue && clearIcon && !disabled;
+    const hasRightAccessories = showClearIcon || addonAfter || allowStep;
+    const currentParsedValue = parseInputNumber(displayValue);
+    const stepBaseValue = currentParsedValue.kind === 'number' ? currentParsedValue.value : currentValue;
+    const normalizedCurrentStepValue = typeof stepBaseValue === 'number' ? normalizeNumber(stepBaseValue, constraints) : undefined;
+    const canStep = useCallback((direction) => {
+        if (disabled) {
+            return false;
+        }
+        const nextValue = stepValue(stepBaseValue, direction, constraints);
+        return !Object.is(nextValue, normalizedCurrentStepValue);
+    }, [constraints, disabled, normalizedCurrentStepValue, stepBaseValue]);
+    const handleStep = useCallback((direction) => {
+        const nextValue = stepValue(stepBaseValue, direction, constraints);
+        const nextDisplayValue = formatDisplayValue(nextValue, constraints);
+        const syntheticEvent = createSyntheticChangeEvent(nextDisplayValue);
+        setDisplayValue(nextDisplayValue);
+        emitChange(nextValue, syntheticEvent, true);
+        inputRef.current?.focus();
+    }, [constraints, createSyntheticChangeEvent, emitChange, stepBaseValue]);
+    const handleClear = useCallback((e) => {
+        e.preventDefault();
+        e.stopPropagation();
+        const syntheticEvent = createSyntheticChangeEvent('');
+        setDisplayValue('');
+        emitChange(undefined, syntheticEvent, true);
+        inputRef.current?.focus();
+    }, [createSyntheticChangeEvent, emitChange]);
+    return (_jsxs("div", { className: cn('tc-ui-input-number relative w-full', className), children: [_jsx("input", { ref: setRefs, type: "text", value: displayValue, onChange: handleChange, inputMode: inputMode, className: cn('flex w-full rounded-lg px-4 py-3 text-sm', 'border transition-colors duration-200', 'placeholder:text-muted-foreground', 'focus:outline-none', showClearIcon && !allowStep && !addonAfter && 'pr-10', hasRightAccessories && 'pr-24', allowStep && addonAfter && 'pr-28', disabled ? 'cursor-not-allowed bg-muted border-border text-muted-foreground' : 'bg-background', !disabled && !hasValue && !isFocused && 'border-border', !disabled && (hasValue || isFocused) && 'border-theme', inputClassName), onFocus: handleFocus, onBlur: handleBlur, disabled: disabled, ...props }), hasRightAccessories && (_jsxs("div", { className: "absolute right-2 top-1/2 flex -translate-y-1/2 items-center gap-1", children: [showClearIcon && (_jsx("button", { type: "button", onMouseDown: (e) => e.preventDefault(), onClick: handleClear, children: clearIcon })), addonAfter && _jsx("div", { children: addonAfter }), allowStep && (_jsxs("div", { className: "flex flex-col overflow-hidden rounded-md border border-border", children: [_jsx("button", { type: "button", onMouseDown: (e) => e.preventDefault(), onClick: () => handleStep('up'), disabled: !canStep('up'), className: cn('flex h-4 w-4 items-center justify-center bg-background text-foreground transition-colors', 'border-b border-border', 'disabled:cursor-not-allowed disabled:text-muted-foreground', !disabled && canStep('up') && 'hover:bg-muted'), children: _jsx(ChevronUp, { size: 12 }) }), _jsx("button", { type: "button", onMouseDown: (e) => e.preventDefault(), onClick: () => handleStep('down'), disabled: !canStep('down'), className: cn('flex h-4 w-4 items-center justify-center bg-background text-foreground transition-colors', 'disabled:cursor-not-allowed disabled:text-muted-foreground', !disabled && canStep('down') && 'hover:bg-muted'), children: _jsx(ChevronDown, { size: 12 }) })] }))] }))] }));
+});
+InputNumber.displayName = 'InputNumber';
+export { InputNumber };

package/fe/packages/ui/react/components/InputNumber/index.d.ts

@@ -0,0 +1,2 @@
+export * from './InputNumber';
+//# sourceMappingURL=index.d.ts.map

package/fe/packages/ui/react/components/InputNumber/index.js

@@ -0,0 +1 @@
+export * from './InputNumber';

package/fe/packages/ui/react/components/InputNumber/inputNumberUtils.d.ts

@@ -0,0 +1,30 @@
+export interface InputNumberConstraints {
+    min?: number;
+    max?: number;
+    precision?: number;
+    step?: number;
+}
+export type ParsedInputNumber = {
+    kind: 'empty';
+} | {
+    kind: 'incomplete';
+} | {
+    kind: 'invalid';
+} | {
+    kind: 'number';
+    value: number;
+};
+export type StepDirection = 'up' | 'down';
+export declare const isValidNumberInput: (value: string) => boolean;
+export declare const clampValue: (value: number, constraints: InputNumberConstraints) => number;
+export declare const applyPrecision: (value: number, precision?: number) => number;
+export declare const normalizeNumber: (value: number, constraints: InputNumberConstraints) => number;
+export declare const formatNumber: (value: number, constraints: InputNumberConstraints) => string;
+export declare const parseInputNumber: (value: string) => ParsedInputNumber;
+export declare const shouldSyncDisplayValue: ({ isFocused, displayValue, currentValue, }: {
+    isFocused: boolean;
+    displayValue: string;
+    currentValue: number | undefined;
+}) => boolean;
+export declare const stepValue: (currentValue: number | undefined, direction: StepDirection, constraints: InputNumberConstraints) => number;
+//# sourceMappingURL=inputNumberUtils.d.ts.map

package/fe/packages/ui/react/components/InputNumber/inputNumberUtils.js

@@ -0,0 +1,63 @@
+const isFiniteNumber = (value) => typeof value === 'number' && Number.isFinite(value);
+export const isValidNumberInput = (value) => /^-?\d*(\.\d*)?$/.test(value);
+export const clampValue = (value, constraints) => {
+    let nextValue = value;
+    if (isFiniteNumber(constraints.min)) {
+        nextValue = Math.max(nextValue, constraints.min);
+    }
+    if (isFiniteNumber(constraints.max)) {
+        nextValue = Math.min(nextValue, constraints.max);
+    }
+    return nextValue;
+};
+export const applyPrecision = (value, precision) => {
+    if (typeof precision !== 'number' || precision < 0) {
+        return value;
+    }
+    return Number(value.toFixed(precision));
+};
+export const normalizeNumber = (value, constraints) => {
+    return clampValue(applyPrecision(value, constraints.precision), constraints);
+};
+export const formatNumber = (value, constraints) => {
+    const normalized = normalizeNumber(value, constraints);
+    if (typeof constraints.precision === 'number' && constraints.precision >= 0) {
+        return normalized.toFixed(constraints.precision);
+    }
+    return String(normalized);
+};
+export const parseInputNumber = (value) => {
+    if (value === '') {
+        return { kind: 'empty' };
+    }
+    if (value === '-' || value === '.' || value === '-.' || /^-?\d+\.$/.test(value)) {
+        return { kind: 'incomplete' };
+    }
+    if (!isValidNumberInput(value)) {
+        return { kind: 'invalid' };
+    }
+    const parsedValue = Number(value);
+    if (!Number.isFinite(parsedValue)) {
+        return { kind: 'invalid' };
+    }
+    return { kind: 'number', value: parsedValue };
+};
+export const shouldSyncDisplayValue = ({ isFocused, displayValue, currentValue, }) => {
+    if (!isFocused) {
+        return true;
+    }
+    const parsedDisplayValue = parseInputNumber(displayValue);
+    if (parsedDisplayValue.kind === 'incomplete' || parsedDisplayValue.kind === 'invalid') {
+        return false;
+    }
+    if (parsedDisplayValue.kind === 'empty') {
+        return currentValue !== undefined;
+    }
+    return !Object.is(parsedDisplayValue.value, currentValue);
+};
+export const stepValue = (currentValue, direction, constraints) => {
+    const step = constraints.step && constraints.step > 0 ? constraints.step : 1;
+    const baseValue = isFiniteNumber(currentValue) ? currentValue : 0;
+    const delta = direction === 'up' ? step : -step;
+    return normalizeNumber(baseValue + delta, constraints);
+};

package/fe/packages/ui/react/components/InputNumber/inputNumberUtils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inputNumberUtils.test.d.ts.map

package/fe/packages/ui/react/components/InputNumber/inputNumberUtils.test.js

@@ -0,0 +1,27 @@
+import assert from 'node:assert/strict';
+import test from 'node:test';
+import { clampValue, formatNumber, parseInputNumber, shouldSyncDisplayValue, stepValue } from './inputNumberUtils';
+test('parseInputNumber keeps empty and transitional values unresolved', () => {
+    assert.deepEqual(parseInputNumber(''), { kind: 'empty' });
+    assert.deepEqual(parseInputNumber('-'), { kind: 'incomplete' });
+    assert.deepEqual(parseInputNumber('.'), { kind: 'incomplete' });
+    assert.deepEqual(parseInputNumber('1.'), { kind: 'incomplete' });
+    assert.deepEqual(parseInputNumber('-1.'), { kind: 'incomplete' });
+    assert.deepEqual(parseInputNumber('1.25'), { kind: 'number', value: 1.25 });
+});
+test('formatNumber applies precision and clamps boundaries', () => {
+    assert.equal(formatNumber(1.236, { precision: 2 }), '1.24');
+    assert.equal(formatNumber(12, { max: 10 }), '10');
+    assert.equal(clampValue(-3, { min: 0 }), 0);
+});
+test('stepValue respects min max precision and step', () => {
+    assert.equal(stepValue(undefined, 'up', { step: 0.25, precision: 2 }), 0.25);
+    assert.equal(stepValue(9.9, 'up', { step: 1, max: 10, precision: 1 }), 10);
+    assert.equal(stepValue(0.3, 'down', { step: 0.2, min: 0, precision: 1 }), 0.1);
+});
+test('shouldSyncDisplayValue preserves editable decimals while focused', () => {
+    assert.equal(shouldSyncDisplayValue({ isFocused: true, displayValue: '12.5', currentValue: 12.5 }), false);
+    assert.equal(shouldSyncDisplayValue({ isFocused: true, displayValue: '12.56', currentValue: 12.56 }), false);
+    assert.equal(shouldSyncDisplayValue({ isFocused: true, displayValue: '12.56', currentValue: 3.14 }), true);
+    assert.equal(shouldSyncDisplayValue({ isFocused: false, displayValue: '12.56', currentValue: 12.56 }), true);
+});

package/fe/packages/ui/react/components/Label/Label.js

@@ -27,9 +27,9 @@ const Label = forwardRef((props, ref) => {
         };
     }, [props]);
     if (isVertical) {
-        return (_jsxs("div", { ref: ref, className: cn('flex flex-col gap-2', className), children: [_jsx("label", { htmlFor: htmlFor, className: labelStyles, children: label }), _jsx("div", { className: cn('w-full', contentClassName), children: children })] }));
+        return (_jsxs("div", { ref: ref, className: cn('tc-ui-label flex flex-col gap-2', className), children: [_jsx("label", { htmlFor: htmlFor, className: labelStyles, children: label }), _jsx("div", { className: cn('w-full', contentClassName), children: children })] }));
     }
-    return (_jsxs("div", { ref: ref, className: cn('flex items-center gap-4', className), children: [_jsx("label", { htmlFor: htmlFor, className: cn(labelStyles, usedClassName), style: { width: labelWidth, flexShrink: 0 }, children: label }), _jsx("div", { className: cn('flex-1', contentClassName), children: children })] }));
+    return (_jsxs("div", { ref: ref, className: cn('tc-ui-label flex items-center gap-4', className), children: [_jsx("label", { htmlFor: htmlFor, className: cn(labelStyles, usedClassName), style: { width: labelWidth, flexShrink: 0 }, children: label }), _jsx("div", { className: cn('flex-1', contentClassName), children: children })] }));
 });
 Label.displayName = 'Label';
 export { Label };

package/fe/packages/ui/react/components/Menu/Menu.d.ts

@@ -0,0 +1,18 @@
+import { type FC } from "react";
+import { MenuItem } from "./MenuItem";
+import { SubMenu } from "./SubMenu";
+import type { MenuProps } from "./menuTypes";
+export interface CollapseToggleHandle {
+    collapse: () => void;
+    expand: () => void;
+}
+export interface CollapseToggleProps {
+    className?: string;
+}
+export declare const CollapseToggle: import("react").ForwardRefExoticComponent<CollapseToggleProps & import("react").RefAttributes<CollapseToggleHandle>>;
+export declare const Menu: FC<MenuProps> & {
+    Item: typeof MenuItem;
+    SubMenu: typeof SubMenu;
+    CollapseToggle: typeof CollapseToggle;
+};
+//# sourceMappingURL=Menu.d.ts.map

package/fe/packages/ui/react/components/Menu/Menu.js

@@ -0,0 +1,102 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { cn } from "../../lib/utils";
+import { forwardRef, useEffect, useImperativeHandle, useRef, } from "react";
+import { ChevronLeft, ChevronRight } from "lucide-react";
+import { CollapsedContext, useMenuStore, MenuStoreContext, createMenuContextValue, } from "./MenuContext";
+import { MenuItem } from "./MenuItem";
+import { SubMenu } from "./SubMenu";
+function renderItems(items, parentKey) {
+    return items.map((item) => {
+        if (item.children && item.children.length > 0) {
+            return (_jsx(SubMenu, { eventKey: item.key, label: item.label, icon: item.icon, disabled: item.disabled, popup: item.popup, parentKey: parentKey, children: renderItems(item.children, item.key) }, item.key));
+        }
+        return (_jsx(MenuItem, { eventKey: item.key, icon: item.icon, disabled: item.disabled, danger: item.danger, onClick: item.onClick, className: item.className, style: item.style, width: item.width, minWidth: item.minWidth, maxWidth: item.maxWidth, children: item.label }, item.key));
+    });
+}
+export const CollapseToggle = forwardRef(({ className }, ref) => {
+    const collapsed = useMenuStore((s) => s.collapsed);
+    const setCollapsed = useMenuStore((s) => s.setCollapsed);
+    const onCollapse = useMenuStore((s) => s.onCollapse);
+    const propsCollapsed = useMenuStore((s) => s.propsCollapsed);
+    const shouldShowCollapseToggle = () => {
+        /**
+         * 传入 collapsed 且没有 onCollapse 时，表示折叠状态完全由外部控制。
+         * 内部控制器无法改变状态，因此不渲染。
+         */
+        if (typeof propsCollapsed !== "undefined" &&
+            typeof onCollapse === "undefined") {
+            return false;
+        }
+        return true;
+    };
+    useImperativeHandle(ref, () => ({
+        collapse: () => setCollapsed(true),
+        expand: () => setCollapsed(false),
+    }), [setCollapsed]);
+    if (!shouldShowCollapseToggle()) {
+        return null;
+    }
+    return (_jsx("div", { role: "button", onClick: () => setCollapsed(!collapsed), className: cn("mx-1 mb-1 flex h-9 cursor-pointer items-center justify-center rounded-lg", "text-muted-foreground transition-all", "hover:bg-muted/60 hover:text-foreground", className), children: collapsed ? (_jsx(ChevronRight, { className: "h-4 w-4" })) : (_jsx(ChevronLeft, { className: "h-4 w-4" })) }));
+});
+CollapseToggle.displayName = "CollapseToggle";
+function MenuInner({ children, items, className, mode, }) {
+    const collapsed = useMenuStore((s) => s.collapsed);
+    const collapsedWidth = useMenuStore((s) => s.collapsedWidth);
+    const content = items ? renderItems(items) : children;
+    return (_jsxs("nav", { role: "menu", className: cn("tc-ui-menu relative overflow-hidden rounded-xl bg-background shadow-sm", mode === "left" && "flex flex-col p-1", mode === "top" && "flex flex-row items-center p-[3px]", className), style: mode === "left" && collapsed ? { width: collapsedWidth } : undefined, children: [mode === "left" && _jsx(CollapseToggle, {}), _jsx(CollapsedContext.Provider, { value: mode === "left" && collapsed, children: _jsx("div", { className: cn(mode === "left" && "flex flex-col gap-1", mode === "top" && "flex flex-row items-center gap-1"), children: content }) })] }));
+}
+export const Menu = ({ mode = "left", expandTrigger = "click", expandMode = "accordion", selectedKey: controlledSelectedKey, defaultSelectedKey, onSelect, items, children, className, collapsed: controlledCollapsed, defaultCollapsed, onCollapse, collapsedWidth = 64, collapsedLabelTooltip = true, }) => {
+    const storeRef = useRef(null);
+    if (!storeRef.current) {
+        storeRef.current = createMenuContextValue({
+            mode,
+            expandTrigger,
+            expandMode,
+            selectedKey: controlledSelectedKey,
+            defaultSelectedKey,
+            collapsed: controlledCollapsed,
+            propsCollapsed: controlledCollapsed,
+            defaultCollapsed,
+            collapsedWidth,
+            collapsedLabelTooltip,
+            onSelect,
+            onCollapse,
+        });
+    }
+    const store = storeRef.current;
+    useEffect(() => {
+        store.setState({
+            mode,
+            expandTrigger,
+            expandMode,
+            propsCollapsed: controlledCollapsed,
+            collapsedWidth,
+            collapsedLabelTooltip,
+            onSelect,
+            onCollapse,
+        });
+    }, [
+        mode,
+        expandTrigger,
+        expandMode,
+        controlledCollapsed,
+        collapsedWidth,
+        collapsedLabelTooltip,
+        onSelect,
+        onCollapse,
+    ]);
+    useEffect(() => {
+        if (controlledSelectedKey !== undefined) {
+            store.setState({ selectedKey: controlledSelectedKey });
+        }
+    }, [controlledSelectedKey]);
+    useEffect(() => {
+        if (controlledCollapsed !== undefined) {
+            store.setState({ collapsed: controlledCollapsed });
+        }
+    }, [controlledCollapsed]);
+    return (_jsx(MenuStoreContext.Provider, { value: store, children: _jsx(MenuInner, { mode: mode, items: items, className: className, children: children }) }));
+};
+Menu.Item = MenuItem;
+Menu.SubMenu = SubMenu;
+Menu.CollapseToggle = CollapseToggle;