knight-ui 1.0.0

package/component/plus/HotKeys.d.ts

@@ -0,0 +1,29 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * 快捷键。
+ * 注册全局键盘快捷键.
+ */
+export declare class HotKeys extends AbstractUI<HotKeysProps, UIState> {
+    private handler;
+    constructor(props: HotKeysProps);
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: Readonly<HotKeysProps>): void;
+    componentWillUnmount(): void;
+    private bindKeys;
+    private unbindKeys;
+    private static buildCombo;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface HotKeysProps extends UIProps {
+    keys?: string[];
+    attach?: HTMLElement | Document;
+    onKeyDown?: (e: {
+        keys: string;
+        nativeEvent: KeyboardEvent;
+    }) => void;
+    onKeyUp?: (e: {
+        keys: string;
+        nativeEvent: KeyboardEvent;
+    }) => void;
+}

package/component/plus/JsonViewer.d.ts

@@ -0,0 +1,34 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * JSON 查看/编辑器 — 基于 Monaco Editor.
+ * 默认只读查看模式, readOnly=false 时可编辑.
+ */
+export declare class JsonViewer extends AbstractUI<JsonViewerProps, JsonViewerState> {
+    private editor;
+    private monaco;
+    private editorWrapRef;
+    private resizeObserver;
+    private pendingValue;
+    constructor(props: JsonViewerProps);
+    componentDidUpdate(prevProps: Readonly<JsonViewerProps>): void;
+    componentWillUnmount(): void;
+    setValue(value: string): void;
+    getEditor(): any;
+    private static normalizeValue;
+    private OnEditorMount;
+    private handleFormat;
+    private handleChange;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface JsonViewerProps extends UIProps {
+    value?: string | object;
+    readOnly?: boolean;
+    onChange?: (value: string) => void;
+    height?: number;
+    theme?: "vs-dark" | "light";
+}
+interface JsonViewerState extends UIState {
+    lastExternalValue: string;
+}
+export {};

package/component/plus/Lottie.d.ts

@@ -0,0 +1,40 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * Lottie 动画播放器。
+ * 需在宿主应用中安装 lottie-web 并通过 props 传入 lottie 实例.
+ * 用法: import lottie from "lottie-web"; <Lottie src={animData} lottie={lottie} />
+ */
+export declare class Lottie extends AbstractUI<LottieProps, LottieState> {
+    private containerRef;
+    private lottieInstance;
+    constructor(props: LottieProps);
+    componentDidMount(): void;
+    componentDidUpdate(prevProps: Readonly<LottieProps>): void;
+    componentWillUnmount(): void;
+    private loadAnimation;
+    private destroy;
+    play(): void;
+    pause(): void;
+    stop(): void;
+    setSpeed(speed: number): void;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface LottieProps extends UIProps {
+    /** lottie-web 模块实例 (由宿主应用传入, 避免构建时解析可选依赖) */
+    lottie?: any;
+    src?: string | object;
+    autoPlay?: boolean;
+    loop?: boolean;
+    speed?: number;
+    width?: number;
+    height?: number;
+    fallback?: React.ReactNode;
+    onComplete?: () => void;
+    onLoopComplete?: () => void;
+    onError?: () => void;
+}
+interface LottieState extends UIState {
+    playing: boolean;
+}
+export {};

package/component/plus/Markdown.d.ts

@@ -0,0 +1,22 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+/**
+ * Markdown 渲染器 — 基于 react-markdown + remark-gfm.
+ * 支持完整 CommonMark + GFM: 表格/任务列表/删除线/链接/图片/代码块/引用.
+ */
+export declare class Markdown extends AbstractUI<MarkdownProps, MarkdownState> {
+    constructor(props: MarkdownProps);
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    private onWheel;
+    private static readonly components;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface MarkdownProps extends UIProps {
+    source?: string;
+    renderMode?: "default" | "preview" | "raw";
+    /** 最大可视行数 (每行约 18px) */
+    rows?: number;
+}
+export interface MarkdownState extends UIState {
+}

package/component/plus/VideoPlayer.d.ts

@@ -0,0 +1,84 @@
+import React from "react";
+import { AbstractUI, type UIProps, type UIState } from "../../base";
+export interface VideoPlayerAPI {
+    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;
+    toggleFullscreen(): void;
+    togglePictureInPicture(): Promise<void>;
+    getVideoElement(): HTMLVideoElement | null;
+    getContainerElement(): HTMLDivElement | null;
+}
+export interface VideoPlayerState {
+    playing: boolean;
+    currentTime: number;
+    duration: number;
+    buffered: number;
+    volume: number;
+    muted: boolean;
+    playbackRate: number;
+    isFullscreen: boolean;
+}
+interface InternalState extends UIState {
+    playing: boolean;
+    currentTime: number;
+    duration: number;
+    buffered: number;
+    volume: number;
+    muted: boolean;
+    playbackRate: number;
+    isFullscreen: boolean;
+    showVolume: boolean;
+    showSpeed: boolean;
+    controlsVisible: boolean;
+}
+export declare class VideoPlayer extends AbstractUI<VideoPlayerProps, InternalState> {
+    private videoRef;
+    private containerRef;
+    private hideTimer;
+    private volumeLeaveTimer;
+    private speedLeaveTimer;
+    private _api;
+    constructor(props: VideoPlayerProps);
+    componentDidMount(): void;
+    componentWillUnmount(): void;
+    getAPI(): VideoPlayerAPI;
+    private onFullscreenChange;
+    private resetHideTimer;
+    private handlePlay;
+    private handlePause;
+    private handleTimeUpdate;
+    private handleLoadedMetadata;
+    private handleEnded;
+    private handleProgressClick;
+    private handleVolumeBarClick;
+    private openVolume;
+    private scheduleVolumeClose;
+    private openSpeed;
+    private scheduleSpeedClose;
+    private handleContainerMouseMove;
+    private handleContainerMouseLeave;
+    protected OnRenderContent(): React.ReactElement;
+}
+export interface VideoPlayerProps extends UIProps {
+    src?: string;
+    autoPlay?: boolean;
+    loop?: boolean;
+    poster?: string;
+    width?: number | string;
+    height?: number;
+    muted?: boolean;
+    controls?: React.ReactNode | ((api: VideoPlayerAPI, state: VideoPlayerState) => 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/index.d.ts

@@ -0,0 +1,20 @@
+export { AudioPlayer } from "./AudioPlayer";
+export type { AudioPlayerProps } from "./AudioPlayer";
+export { Chat } from "./Chat";
+export type { ChatProps } from "./Chat";
+export { CodeEditor } from "./CodeEditor";
+export type { CodeEditorProps } from "./CodeEditor";
+export { CodeHighlight } from "./CodeHighlight";
+export type { CodeHighlightProps } from "./CodeHighlight";
+export { DragMove } from "./DragMove";
+export type { DragMoveProps } from "./DragMove";
+export { HotKeys } from "./HotKeys";
+export type { HotKeysProps } from "./HotKeys";
+export { JsonViewer } from "./JsonViewer";
+export type { JsonViewerProps } from "./JsonViewer";
+export { Lottie } from "./Lottie";
+export type { LottieProps } from "./Lottie";
+export { Markdown } from "./Markdown";
+export type { MarkdownProps } from "./Markdown";
+export { VideoPlayer } from "./VideoPlayer";
+export type { VideoPlayerProps } from "./VideoPlayer";

package/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./base";
+export * from "./component";
+export * from "./test";