knight-ui 1.0.0

package/component/navigation/BackTop.d.ts

@@ -0,0 +1,28 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * 回到顶部。
+ */
+export declare class BackTop extends AbstractUI<BackTopProps, BackTopState> {
+    private scrollContainer;
+    constructor(props: BackTopProps);
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    protected OnRenderContent(): React.ReactElement;
+    private onScroll;
+    private scrollToTop;
+}
+export interface BackTopProps extends UIProps {
+    /** 滚动高度达到此值后显示按钮，默认 400 */
+    visibilityHeight?: number;
+    /** 滚动动画时长(ms)，默认 450 */
+    duration?: number;
+    /** 监听滚动的容器，默认 window */
+    target?: () => HTMLElement | Window;
+    /** 点击回调 */
+    onClick?: () => void;
+}
+interface BackTopState extends UIState {
+    show: boolean;
+}
+export {};

package/component/navigation/Breadcrumb.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+declare class BreadcrumbItem extends AbstractUI<BreadcrumbItemProps, UIState> {
+    static displayName: string;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface BreadcrumbItemProps extends UIProps {
+    href?: string;
+    icon?: React.ReactNode;
+    onClick?: () => void;
+    tooltip?: React.ReactNode;
+}
+export interface BreadcrumbRoute {
+    path?: string;
+    name: string;
+    icon?: React.ReactNode;
+    tooltip?: React.ReactNode;
+}
+/**
+ * 面包屑。
+ */
+export declare class Breadcrumb extends AbstractUI<BreadcrumbProps, BreadcrumbState> {
+    static Item: typeof BreadcrumbItem;
+    constructor(props: BreadcrumbProps);
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface BreadcrumbProps extends UIProps {
+    separator?: React.ReactNode;
+    routes?: BreadcrumbRoute[];
+}
+interface BreadcrumbState extends UIState {
+}
+export {};

package/component/navigation/Navigation.d.ts

@@ -0,0 +1,48 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+export interface NavItem {
+    key: string;
+    label: string;
+    icon?: React.ReactNode;
+    disabled?: boolean;
+    children?: NavItem[];
+}
+type TriggerMode = "hover" | "click";
+/**
+ * 导航菜单。
+ */
+export declare class Navigation extends AbstractUI<NavigationProps, NavigationState> {
+    constructor(props: NavigationProps);
+    componentDidUpdate(prevProps: Readonly<NavigationProps>): void;
+    protected OnRenderContent(): React.ReactElement;
+    private renderItem;
+    private renderDropdownItem;
+    private setHover;
+    private clearHover;
+    private toggleHover;
+    private toggleOpen;
+    private select;
+}
+export interface NavigationProps extends UIProps {
+    items?: NavItem[];
+    mode?: "horizontal" | "vertical";
+    isCollapsed?: boolean;
+    defaultIsCollapsed?: boolean;
+    onCollapseChange?: (isCollapsed: boolean) => void;
+    /** 水平模式子菜单触发方式，默认 "hover" */
+    trigger?: TriggerMode;
+    openKeys?: string[];
+    defaultOpenKeys?: string[];
+    selectedKeys?: string[];
+    defaultSelectedKeys?: string[];
+    multiple?: boolean;
+    onSelect?: (key: string) => void;
+    onOpenChange?: (openKeys: string[]) => void;
+}
+interface NavigationState extends UIState {
+    _openKeys: string[];
+    _selectedKeys: string[];
+    _hoverKey: string | null;
+    _isCollapsed: boolean;
+}
+export {};

package/component/navigation/Pagination.d.ts

@@ -0,0 +1,32 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * 分页。
+ */
+export declare class Pagination extends AbstractUI<PaginationProps, PaginationState> {
+    constructor(props: PaginationProps);
+    componentDidUpdate(prevProps: Readonly<PaginationProps>): void;
+    protected OnRenderContent(): React.ReactElement;
+    private getPageRange;
+    private goTo;
+    private handlePageSizeChange;
+}
+export interface PaginationProps extends UIProps {
+    total: number;
+    current?: number;
+    defaultCurrent?: number;
+    pageSize?: number;
+    defaultPageSize?: number;
+    showSizeChanger?: boolean;
+    showQuickJumper?: boolean;
+    showTotal?: boolean;
+    pageSizeOpts?: number[];
+    onChange?: (page: number, pageSize: number) => void;
+    onPageSizeChange?: (pageSize: number) => void;
+}
+interface PaginationState extends UIState {
+    _current: number;
+    _pageSize: number;
+    _sizeOpen: boolean;
+}
+export {};

package/component/navigation/Steps.d.ts

@@ -0,0 +1,52 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+type StepStatus = "wait" | "process" | "finish" | "error" | "warning";
+type StepsType = "primary" | "basic" | "nav";
+type StepsSize = "small" | "default";
+interface StepsContextValue {
+    current: number;
+    direction: "horizontal" | "vertical";
+    status: StepStatus;
+    type: StepsType;
+    size: StepsSize;
+}
+declare const StepsContext: React.Context<StepsContextValue>;
+declare class Step extends AbstractUI<StepProps, UIState> {
+    static displayName: string;
+    static contextType: React.Context<StepsContextValue>;
+    context: React.ContextType<typeof StepsContext>;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface StepProps extends UIProps {
+    title?: React.ReactNode;
+    description?: React.ReactNode;
+    status?: StepStatus;
+}
+/**
+ * 步骤条。
+ * type="basic" 为简单步骤条(新版), type="primary" 为主步骤条.
+ */
+export declare class Steps extends AbstractUI<StepsProps, StepsState> {
+    static Step: typeof Step;
+    constructor(props: StepsProps);
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface StepsProps extends UIProps {
+    /** 当前步骤索引(0-based)，默认 0 */
+    current?: number;
+    /** 当前步骤状态 */
+    status?: StepStatus;
+    /** 方向 */
+    direction?: "horizontal" | "vertical";
+    /** 步骤条类型: basic 简单步骤条(新版), primary 主步骤条, nav 导航步骤条 */
+    type?: StepsType;
+    /** 是否显示连接线，默认 true */
+    hasLine?: boolean;
+    /** 尺寸，默认 "default" */
+    size?: StepsSize;
+    /** 步骤变化回调 */
+    onChange?: (index: number) => void;
+}
+interface StepsState extends UIState {
+}
+export {};

package/component/navigation/Tabs.d.ts

@@ -0,0 +1,54 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+export interface TabItem {
+    key: string;
+    label: React.ReactNode;
+    content?: React.ReactNode;
+    disabled?: boolean;
+    closable?: boolean;
+}
+declare class TabPane extends AbstractUI<TabPaneProps, UIState> {
+    static displayName: string;
+    protected OnRenderContent(): React.ReactElement;
+}
+interface TabPaneProps extends UIProps {
+    tab: React.ReactNode;
+    itemKey: string;
+    disabled?: boolean;
+}
+type TabType = "line" | "card" | "button";
+type TabPosition = "top" | "left" | "right" | "bottom";
+/**
+ * 标签页。
+ */
+export declare class Tabs extends AbstractUI<TabsProps, TabsState> {
+    static TabPane: typeof TabPane;
+    constructor(props: TabsProps);
+    componentDidUpdate(prevProps: Readonly<TabsProps>): void;
+    protected OnRenderContent(): React.ReactElement;
+    private static buildItems;
+    private switchTab;
+    private handleClose;
+}
+export interface TabsProps extends UIProps {
+    items?: TabItem[];
+    activeKey?: string;
+    defaultActiveKey?: string;
+    type?: TabType;
+    tabPosition?: TabPosition;
+    tabBarExtraContent?: React.ReactNode;
+    /** 标签页溢出时折叠到"更多"下拉菜单 */
+    collapsible?: boolean;
+    /** 显示"+"按钮用于新建标签页 */
+    addable?: boolean;
+    /** 点击"+"按钮回调 */
+    onAddTab?: () => void;
+    /** 关闭标签页回调 */
+    onTabClose?: (key: string) => void;
+    onChange?: (key: string) => void;
+}
+interface TabsState extends UIState {
+    _activeKey: string;
+    _collapseOpen: boolean;
+}
+export {};

package/component/navigation/Tree.d.ts

@@ -0,0 +1,68 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+export interface TreeNodeData {
+    key: string;
+    title: string;
+    children?: TreeNodeData[];
+    disabled?: boolean;
+    icon?: React.ReactNode;
+    checkable?: boolean;
+}
+declare class TreeNodeComp extends AbstractUI<TreeNodeCompProps, UIState> {
+    static displayName: string;
+    protected OnRenderContent(): React.ReactElement;
+}
+interface TreeNodeCompProps extends UIProps {
+    label: React.ReactNode;
+    value: string;
+    disabled?: boolean;
+    checkable?: boolean;
+}
+/**
+ * 树形控件。
+ */
+export declare class Tree extends AbstractUI<TreeProps, TreeState> {
+    static Node: typeof TreeNodeComp;
+    constructor(props: TreeProps);
+    componentDidUpdate(prevProps: Readonly<TreeProps>): void;
+    protected OnRenderContent(): React.ReactElement;
+    private renderNodes;
+    private renderNode;
+    private renderCheckbox;
+    private toggleExpand;
+    private handleSelect;
+    private handleCheck;
+    private addDescendantKeys;
+    private removeDescendantKeys;
+    private collectAllKeys;
+    private static buildTreeData;
+    private findNode;
+}
+export interface TreeProps extends UIProps {
+    treeData?: TreeNodeData[];
+    checkable?: boolean;
+    multiple?: boolean;
+    selectedKeys?: string[];
+    defaultSelectedKeys?: string[];
+    expandedKeys?: string[];
+    defaultExpandedKeys?: string[];
+    defaultExpandAll?: boolean;
+    checkedKeys?: string[];
+    defaultCheckedKeys?: string[];
+    onSelect?: (selectedKeys: string[], selected: boolean, selectedNode: TreeNodeData) => void;
+    onExpand?: (expandedKeys: string[], info: {
+        expanded: boolean;
+        node: TreeNodeData;
+    }) => void;
+    onCheck?: (checkedKeys: string[], checkState: {
+        checked: boolean;
+        halfCheckedKeys: string[];
+        node: TreeNodeData;
+    }) => void;
+}
+interface TreeState extends UIState {
+    _expandedKeys: string[];
+    _selectedKeys: string[];
+    _checkedKeys: string[];
+}
+export {};

package/component/navigation/index.d.ts

@@ -0,0 +1,16 @@
+export { BackTop } from "./BackTop";
+export type { BackTopProps } from "./BackTop";
+export { Breadcrumb } from "./Breadcrumb";
+export type { BreadcrumbProps, BreadcrumbItemProps, BreadcrumbRoute } from "./Breadcrumb";
+export { Anchor } from "./Anchor";
+export type { AnchorProps, AnchorLinkProps } from "./Anchor";
+export { Steps } from "./Steps";
+export type { StepsProps, StepProps } from "./Steps";
+export { Pagination } from "./Pagination";
+export type { PaginationProps } from "./Pagination";
+export { Navigation } from "./Navigation";
+export type { NavigationProps, NavItem } from "./Navigation";
+export { Tabs } from "./Tabs";
+export type { TabsProps, TabItem } from "./Tabs";
+export { Tree } from "./Tree";
+export type { TreeProps, TreeNodeData } from "./Tree";

package/component/other/ConfigProvider.d.ts

@@ -0,0 +1,24 @@
+import React from "react";
+export type ComponentSize = "small" | "middle" | "large";
+interface ConfigContextValue {
+    componentSize?: ComponentSize;
+    getPopupContainer?: () => HTMLElement;
+    direction?: "ltr" | "rtl";
+}
+declare const ConfigContext: React.Context<ConfigContextValue>;
+/**
+ * 全局配置提供者。
+ * 包装在应用根节点,为所有子组件提供统一的全局配置.
+ */
+export declare class ConfigProvider extends React.Component<ConfigProviderProps> {
+    render(): React.ReactNode;
+    /** 通过 Context 获取配置 — 子组件在 render 中调用 */
+    static getContext(): ConfigContextValue;
+}
+export interface ConfigProviderProps {
+    componentSize?: ComponentSize;
+    getPopupContainer?: () => HTMLElement;
+    direction?: "ltr" | "rtl";
+    children?: React.ReactNode;
+}
+export { ConfigContext };

package/component/other/LocaleProvider.d.ts

@@ -0,0 +1,30 @@
+import React from "react";
+interface Locale {
+    locale?: string;
+    okText?: string;
+    cancelText?: string;
+    clearText?: string;
+    placeholder?: string;
+    emptyText?: string;
+    loadingText?: string;
+    searchText?: string;
+    confirmText?: string;
+    [key: string]: string | undefined;
+}
+declare const zhCN: Locale;
+declare const LocaleContext: React.Context<Locale>;
+/**
+ * 国际化提供者。
+ * 包装在应用根节点,为所有子组件提供统一的语言文本.
+ */
+export declare class LocaleProvider extends React.Component<LocaleProviderProps> {
+    render(): React.ReactNode;
+    /** 获取静态 locale 文本(用于非 React 环境的静态方法如 Toast.success()) */
+    static getLocale(): Locale;
+}
+export interface LocaleProviderProps {
+    locale?: Partial<Locale>;
+    children?: React.ReactNode;
+}
+export { LocaleContext, zhCN };
+export type { Locale };

package/component/other/index.d.ts

@@ -0,0 +1,4 @@
+export { ConfigProvider, ConfigContext } from "./ConfigProvider";
+export type { ConfigProviderProps, ComponentSize } from "./ConfigProvider";
+export { LocaleProvider, LocaleContext, zhCN } from "./LocaleProvider";
+export type { LocaleProviderProps, Locale } from "./LocaleProvider";

package/component/plus/AudioPlayer.d.ts

@@ -0,0 +1,70 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+export interface AudioPlayerAPI {
+    play(): void;
+    pause(): void;
+    seek(time: number): void;
+    skipForward(seconds?: number): void;
+    skipBackward(seconds?: number): void;
+    setVolume(vol: number): void;
+    toggleMute(): void;
+    setPlaybackRate(rate: number): void;
+    toggleLoop(): void;
+    getAudioElement(): HTMLAudioElement | null;
+}
+export interface AudioPlayerState {
+    playing: boolean;
+    currentTime: number;
+    duration: number;
+    volume: number;
+    muted: boolean;
+    playbackRate: number;
+    loop: boolean;
+}
+interface InternalState extends UIState {
+    playing: boolean;
+    currentTime: number;
+    duration: number;
+    volume: number;
+    muted: boolean;
+    playbackRate: number;
+    loop: boolean;
+    showVolume: boolean;
+    showSpeed: boolean;
+}
+export declare class AudioPlayer extends AbstractUI<AudioPlayerProps, InternalState> {
+    private audioRef;
+    private volumeLeaveTimer;
+    private speedLeaveTimer;
+    private _api;
+    constructor(props: AudioPlayerProps);
+    componentWillUnmount(): void;
+    getAPI(): AudioPlayerAPI;
+    private handlePlay;
+    private handlePause;
+    private handleTimeUpdate;
+    private handleLoadedMetadata;
+    private handleEnded;
+    private handleProgressClick;
+    private handleVolumeBarClick;
+    private openVolume;
+    private scheduleVolumeClose;
+    private openSpeed;
+    private scheduleSpeedClose;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface AudioPlayerProps extends UIProps {
+    src?: string;
+    autoPlay?: boolean;
+    loop?: boolean;
+    theme?: "dark" | "light";
+    volume?: number;
+    controls?: React.ReactNode | ((api: AudioPlayerAPI, state: AudioPlayerState) => React.ReactNode);
+    onPlay?: () => void;
+    onPause?: () => void;
+    onEnded?: () => void;
+    onError?: () => void;
+    onTimeUpdate?: (currentTime: number, duration: number) => void;
+    onVolumeChange?: (volume: number, muted: boolean) => void;
+}
+export {};

package/component/plus/Chat.d.ts

@@ -0,0 +1,39 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+type MessageRole = "user" | "assistant" | "system";
+interface ChatMessage {
+    id?: string | number;
+    role: MessageRole;
+    content: React.ReactNode;
+    avatar?: string;
+    name?: string;
+    time?: string;
+    status?: "sending" | "sent" | "error";
+}
+/**
+ * 对话消息列表。
+ */
+export declare class Chat extends AbstractUI<ChatProps, ChatState> {
+    private listRef;
+    constructor(props: ChatProps);
+    componentDidUpdate(prevProps: Readonly<ChatProps>): void;
+    componentDidMount(): void;
+    private scrollToBottom;
+    private handleSend;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface ChatProps extends UIProps {
+    dataSource?: ChatMessage[];
+    renderMessage?: (msg: ChatMessage, index: number) => React.ReactNode;
+    onSend?: (content: string) => void;
+    onRetry?: (msg: ChatMessage, index: number) => void;
+    loading?: boolean;
+    emptyContent?: React.ReactNode;
+    showInput?: boolean;
+    placeholder?: string;
+    sendText?: string;
+}
+interface ChatState extends UIState {
+    inputValue: string;
+}
+export {};

package/component/plus/CodeEditor.d.ts

@@ -0,0 +1,86 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * 代码编辑器 — 基于 Monaco Editor 的全功能代码编辑器.
+ *
+ * 用法: <CodeEditor ref={ref} value={code} language="typescript" onChange={(v) => setCode(v)} />
+ * 通过 ref 可调用 setValue(v)、getMonaco()、getEditor().
+ */
+export declare class CodeEditor extends AbstractUI<CodeEditorProps, CodeEditorState> {
+    private editor;
+    private monaco;
+    private editorWrapRef;
+    private resizeObserver;
+    private pendingValue;
+    private readonly editorPath;
+    private readonly initialValue;
+    private static readonly LANGUAGES;
+    constructor(props: CodeEditorProps);
+    componentDidUpdate(prevProps: Readonly<CodeEditorProps>): void;
+    componentWillUnmount(): void;
+    /** 程序化写入编辑器内容，不触发 onChange */
+    setValue(value: string): void;
+    /** 获取 Monaco 命名空间 */
+    getMonaco(): any;
+    /** 获取 Monaco editor 实例 */
+    getEditor(): any;
+    /** Monaco 挂载回调 */
+    private OnEditorMount;
+    /** 挂载前配置 Monaco 环境，稳定诊断/IntelliSense */
+    private beforeMount;
+    /** 切换语言 — 更新内部状态 + 回调 + 直接操作 Monaco 模型 */
+    private handleLanguageChange;
+    /** 通过 Monaco API 直接设置编辑器模型语言 */
+    private applyLanguage;
+    /** 格式化代码 */
+    private OnFormat;
+    /** 复制编辑器内容 */
+    private handleCopy;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface CodeEditorProps extends UIProps {
+    /** 编辑器初始内容(非受控),优先于 value */
+    defaultValue?: string;
+    /** 编辑器内容(受控) */
+    value?: string;
+    /** 内容变化回调 */
+    onChange?: (value: string) => void;
+    /** Monaco 语言标识 @default "typescript" */
+    language?: string;
+    /** 语言切换回调 */
+    onLanguageChange?: (language: string) => void;
+    /** 编辑器高度(px) @default 300 */
+    height?: number;
+    /** 编辑器最小高度(px) */
+    minHeight?: number;
+    /** 编辑器宽度 */
+    width?: number | string;
+    /** 编辑器最小宽度(px) */
+    minWidth?: number;
+    /** Monaco 主题 @default "vs-dark" */
+    theme?: "vs-dark" | "light" | "hc-black";
+    /** 只读 @default false */
+    readOnly?: boolean;
+    /** 显示缩略图 @default false */
+    minimap?: boolean;
+    /** 自动换行 @default true */
+    wordWrap?: boolean;
+    /** 显示行号 @default true */
+    showLineNumbers?: boolean;
+    /** 字体大小 @default 12 */
+    fontSize?: number;
+    /** Tab 宽度 @default 2 */
+    tabSize?: number;
+    /** 显示复制按钮 @default true */
+    showCopyBtn?: boolean;
+    /** 显示格式化按钮 @default true */
+    showFormatBtn?: boolean;
+    /** 显示语言切换下拉 @default true */
+    showLanguageSwitcher?: boolean;
+}
+interface CodeEditorState extends UIState {
+    copied: boolean;
+    currentLanguage: string;
+    editorHeight: number;
+}
+export {};

package/component/plus/CodeHighlight.d.ts

@@ -0,0 +1,33 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * 代码高亮 — 基于 Monaco Editor 的只读代码查看器.
+ *
+ */
+export declare class CodeHighlight extends AbstractUI<CodeHighlightProps, CodeHighlightState> {
+    private editor;
+    private monaco;
+    private editorWrapRef;
+    private resizeObserver;
+    private pendingCode;
+    constructor(props: CodeHighlightProps);
+    componentDidUpdate(prevProps: Readonly<CodeHighlightProps>): void;
+    componentWillUnmount(): void;
+    setCode(value: string): void;
+    private OnEditorMount;
+    private handleCopy;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface CodeHighlightProps extends UIProps {
+    code?: string;
+    language?: string;
+    theme?: "vs-dark" | "light" | "hc-black";
+    showLineNumbers?: boolean;
+    height?: number | string;
+    maxHeight?: number | string;
+    copyable?: boolean;
+}
+interface CodeHighlightState extends UIState {
+    copied: boolean;
+}
+export {};

package/component/plus/DragMove.d.ts

@@ -0,0 +1,51 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * 拖拽移动。
+ * 使子元素可拖拽移动, 支持 mouse 和 touch 事件.
+ */
+export declare class DragMove extends AbstractUI<DragMoveProps, DragMoveState> {
+    private isDragging;
+    private startX;
+    private startY;
+    private startLeft;
+    private startTop;
+    private moveHandler;
+    private endHandler;
+    constructor(props: DragMoveProps);
+    componentWillUnmount(): void;
+    private cleanupListeners;
+    private getClientPos;
+    private handlePointerDown;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface DragMoveProps extends UIProps {
+    initialPosition?: {
+        x: number;
+        y: number;
+    };
+    bounds?: {
+        top?: number;
+        left?: number;
+        right?: number;
+        bottom?: number;
+    };
+    axis?: "x" | "y";
+    onDragStart?: (pos: {
+        x: number;
+        y: number;
+    }) => void;
+    onDrag?: (pos: {
+        x: number;
+        y: number;
+    }) => void;
+    onDragEnd?: (pos: {
+        x: number;
+        y: number;
+    }) => void;
+}
+interface DragMoveState extends UIState {
+    x: number;
+    y: number;
+}
+export {};