zs_library 0.6.21 → 0.7.0

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/dropdown-menu/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/input/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/input/input.d.ts

@@ -0,0 +1,3 @@
+declare function Input({ className, type, ...props }: React.ComponentProps<"input">): import("react/jsx-runtime").JSX.Element;
+declare function InputGroup({ className, children, ...props }: React.ComponentProps<"div">): import("react/jsx-runtime").JSX.Element;
+export { Input, InputGroup };

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/popover/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/popover/popover.d.ts

@@ -0,0 +1,6 @@
+import * as PopoverPrimitive from "@radix-ui/react-popover";
+declare function Popover({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Root>): import("react/jsx-runtime").JSX.Element;
+declare function PopoverTrigger({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Trigger>): import("react/jsx-runtime").JSX.Element;
+declare function PopoverContent({ className, align, sideOffset, ...props }: React.ComponentProps<typeof PopoverPrimitive.Content>): import("react/jsx-runtime").JSX.Element;
+declare function PopoverAnchor({ ...props }: React.ComponentProps<typeof PopoverPrimitive.Anchor>): import("react/jsx-runtime").JSX.Element;
+export { Popover, PopoverTrigger, PopoverContent, PopoverAnchor };

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/separator/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/separator/separator.d.ts

@@ -0,0 +1,6 @@
+export type Orientation = "horizontal" | "vertical";
+export interface SeparatorProps extends React.HTMLAttributes<HTMLDivElement> {
+    orientation?: Orientation;
+    decorative?: boolean;
+}
+export declare const Separator: import('react').ForwardRefExoticComponent<SeparatorProps & import('react').RefAttributes<HTMLDivElement>>;

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/spacer/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/spacer/spacer.d.ts

@@ -0,0 +1,6 @@
+export type SpacerOrientation = "horizontal" | "vertical";
+export interface SpacerProps extends React.HTMLAttributes<HTMLDivElement> {
+    orientation?: SpacerOrientation;
+    size?: string | number;
+}
+export declare function Spacer({ orientation, size, style, ...props }: SpacerProps): import("react/jsx-runtime").JSX.Element;

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/toolbar/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/toolbar/toolbar.d.ts

@@ -0,0 +1,8 @@
+type BaseProps = React.HTMLAttributes<HTMLDivElement>;
+interface ToolbarProps extends BaseProps {
+    variant?: "floating" | "fixed";
+}
+export declare const Toolbar: import('react').ForwardRefExoticComponent<ToolbarProps & import('react').RefAttributes<HTMLDivElement>>;
+export declare const ToolbarGroup: import('react').ForwardRefExoticComponent<BaseProps & import('react').RefAttributes<HTMLDivElement>>;
+export declare const ToolbarSeparator: import('react').ForwardRefExoticComponent<BaseProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/tooltip/index.d.ts

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

package/dist/components/tiptap-editor/simple/components/tiptap-ui-primitive/tooltip/tooltip.d.ts

@@ -0,0 +1,28 @@
+import { FloatingPortal, Placement } from '@floating-ui/react';
+interface TooltipProviderProps {
+    children: React.ReactNode;
+    initialOpen?: boolean;
+    placement?: Placement;
+    open?: boolean;
+    onOpenChange?: (open: boolean) => void;
+    delay?: number;
+    closeDelay?: number;
+    timeout?: number;
+    useDelayGroup?: boolean;
+}
+interface TooltipTriggerProps extends Omit<React.HTMLProps<HTMLElement>, "ref"> {
+    asChild?: boolean;
+    children: React.ReactNode;
+}
+interface TooltipContentProps extends Omit<React.HTMLProps<HTMLDivElement>, "ref"> {
+    children?: React.ReactNode;
+    portal?: boolean;
+    portalProps?: Omit<React.ComponentProps<typeof FloatingPortal>, "children">;
+}
+export declare function Tooltip({ children, ...props }: TooltipProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Tooltip {
+    var displayName: string;
+}
+export declare const TooltipTrigger: import('react').ForwardRefExoticComponent<TooltipTriggerProps & import('react').RefAttributes<HTMLElement>>;
+export declare const TooltipContent: import('react').ForwardRefExoticComponent<TooltipContentProps & import('react').RefAttributes<HTMLDivElement>>;
+export {};

package/dist/components/tiptap-editor/simple/hooks/use-composed-ref.d.ts

@@ -0,0 +1,3 @@
+type UserRef<T> = ((instance: T | null) => void) | React.RefObject<T | null> | null | undefined;
+export declare const useComposedRef: <T extends HTMLElement>(libRef: React.RefObject<T | null>, userRef: UserRef<T>) => (instance: T | null) => void;
+export default useComposedRef;

package/dist/components/tiptap-editor/simple/hooks/use-cursor-visibility.d.ts

@@ -0,0 +1,20 @@
+import { Editor } from '@tiptap/react';
+export interface CursorVisibilityOptions {
+    /**
+     * The Tiptap editor instance
+     */
+    editor?: Editor | null;
+    /**
+     * Reference to the toolbar element that may obscure the cursor
+     */
+    overlayHeight?: number;
+}
+/**
+ * Custom hook that ensures the cursor remains visible when typing in a Tiptap editor.
+ * Automatically scrolls the window when the cursor would be hidden by the toolbar.
+ *
+ * @param options.editor The Tiptap editor instance
+ * @param options.overlayHeight Toolbar height to account for
+ * @returns The bounding rect of the body
+ */
+export declare function useCursorVisibility({ editor, overlayHeight }: CursorVisibilityOptions): import('./use-element-rect').RectState;

package/dist/components/tiptap-editor/simple/hooks/use-element-rect.d.ts

@@ -0,0 +1,35 @@
+export type RectState = Omit<DOMRect, "toJSON">;
+export interface ElementRectOptions {
+    /**
+     * The element to track. Can be an Element, ref, or selector string.
+     * Defaults to document.body if not provided.
+     */
+    element?: Element | React.RefObject<Element> | string | null;
+    /**
+     * Whether to enable rect tracking
+     */
+    enabled?: boolean;
+    /**
+     * Throttle delay in milliseconds for rect updates
+     */
+    throttleMs?: number;
+    /**
+     * Whether to use ResizeObserver for more accurate tracking
+     */
+    useResizeObserver?: boolean;
+}
+/**
+ * Custom hook that tracks an element's bounding rectangle and updates on resize, scroll, etc.
+ *
+ * @param options Configuration options for element rect tracking
+ * @returns The current bounding rectangle of the element
+ */
+export declare function useElementRect({ element, enabled, throttleMs, useResizeObserver, }?: ElementRectOptions): RectState;
+/**
+ * Convenience hook for tracking document.body rect
+ */
+export declare function useBodyRect(options?: Omit<ElementRectOptions, "element">): RectState;
+/**
+ * Convenience hook for tracking a ref element's rect
+ */
+export declare function useRefRect<T extends Element>(ref: React.RefObject<T>, options?: Omit<ElementRectOptions, "element">): RectState;

package/dist/components/tiptap-editor/simple/hooks/use-is-breakpoint.d.ts

@@ -0,0 +1,9 @@
+type BreakpointMode = "min" | "max";
+/**
+ * Hook to detect whether the current viewport matches a given breakpoint rule.
+ * Example:
+ *   useIsBreakpoint("max", 768)   // true when width < 768
+ *   useIsBreakpoint("min", 1024)  // true when width >= 1024
+ */
+export declare function useIsBreakpoint(mode?: BreakpointMode, breakpoint?: number): boolean;
+export {};

package/dist/components/tiptap-editor/simple/hooks/use-menu-navigation.d.ts

@@ -0,0 +1,52 @@
+import { Editor } from '@tiptap/react';
+type Orientation = "horizontal" | "vertical" | "both";
+interface MenuNavigationOptions<T> {
+    /**
+     * The Tiptap editor instance, if using with a Tiptap editor.
+     */
+    editor?: Editor | null;
+    /**
+     * Reference to the container element for handling keyboard events.
+     */
+    containerRef?: React.RefObject<HTMLElement | null>;
+    /**
+     * Search query that affects the selected item.
+     */
+    query?: string;
+    /**
+     * Array of items to navigate through.
+     */
+    items: T[];
+    /**
+     * Callback fired when an item is selected.
+     */
+    onSelect?: (item: T) => void;
+    /**
+     * Callback fired when the menu should close.
+     */
+    onClose?: () => void;
+    /**
+     * The navigation orientation of the menu.
+     * @default "vertical"
+     */
+    orientation?: Orientation;
+    /**
+     * Whether to automatically select the first item when the menu opens.
+     * @default true
+     */
+    autoSelectFirstItem?: boolean;
+}
+/**
+ * Hook that implements keyboard navigation for dropdown menus and command palettes.
+ *
+ * Handles arrow keys, tab, home/end, enter for selection, and escape to close.
+ * Works with both Tiptap editors and regular DOM elements.
+ *
+ * @param options - Configuration options for the menu navigation
+ * @returns Object containing the selected index and a setter function
+ */
+export declare function useMenuNavigation<T>({ editor, containerRef, query, items, onSelect, onClose, orientation, autoSelectFirstItem, }: MenuNavigationOptions<T>): {
+    selectedIndex: number | undefined;
+    setSelectedIndex: import('react').Dispatch<import('react').SetStateAction<number>>;
+};
+export {};

package/dist/components/tiptap-editor/simple/hooks/use-scrolling.d.ts

@@ -0,0 +1,8 @@
+import { RefObject } from 'react';
+type ScrollTarget = RefObject<HTMLElement> | Window | null | undefined;
+interface UseScrollingOptions {
+    debounce?: number;
+    fallbackToDocument?: boolean;
+}
+export declare function useScrolling(target?: ScrollTarget, options?: UseScrollingOptions): boolean;
+export {};

package/dist/components/tiptap-editor/simple/hooks/use-throttled-callback.d.ts

@@ -0,0 +1,18 @@
+interface ThrottleSettings {
+    leading?: boolean | undefined;
+    trailing?: boolean | undefined;
+}
+/**
+ * A hook that returns a throttled callback function.
+ *
+ * @param fn The function to throttle
+ * @param wait The time in ms to wait before calling the function
+ * @param dependencies The dependencies to watch for changes
+ * @param options The throttle options
+ */
+export declare function useThrottledCallback<T extends (...args: any[]) => any>(fn: T, wait?: number, dependencies?: React.DependencyList, options?: ThrottleSettings): {
+    (this: ThisParameterType<T>, ...args: Parameters<T>): ReturnType<T>;
+    cancel: () => void;
+    flush: () => void;
+};
+export default useThrottledCallback;

package/dist/components/tiptap-editor/simple/hooks/use-tiptap-editor.d.ts

@@ -0,0 +1,17 @@
+import { Editor } from '@tiptap/react';
+/**
+ * Hook that provides access to a Tiptap editor instance.
+ *
+ * Accepts an optional editor instance directly, or falls back to retrieving
+ * the editor from the Tiptap context if available. This allows components
+ * to work both when given an editor directly and when used within a Tiptap
+ * editor context.
+ *
+ * @param providedEditor - Optional editor instance to use instead of the context editor
+ * @returns The provided editor or the editor from context, whichever is available
+ */
+export declare function useTiptapEditor(providedEditor?: Editor | null): {
+    editor: Editor | null;
+    editorState?: Editor["state"];
+    canCommand?: Editor["can"];
+};

package/dist/components/tiptap-editor/simple/hooks/use-unmount.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Hook that executes a callback when the component unmounts.
+ *
+ * @param callback Function to be called on component unmount
+ */
+export declare const useUnmount: (callback: (...args: Array<any>) => any) => void;
+export default useUnmount;

package/dist/components/tiptap-editor/simple/hooks/use-window-size.d.ts

@@ -0,0 +1,35 @@
+export interface WindowSizeState {
+    /**
+     * The width of the window's visual viewport in pixels.
+     */
+    width: number;
+    /**
+     * The height of the window's visual viewport in pixels.
+     */
+    height: number;
+    /**
+     * The distance from the top of the visual viewport to the top of the layout viewport.
+     * Particularly useful for handling mobile keyboard appearance.
+     */
+    offsetTop: number;
+    /**
+     * The distance from the left of the visual viewport to the left of the layout viewport.
+     */
+    offsetLeft: number;
+    /**
+     * The scale factor of the visual viewport.
+     * This is useful for scaling elements based on the current zoom level.
+     */
+    scale: number;
+}
+/**
+ * Hook that tracks the window's visual viewport dimensions, position, and provides
+ * a CSS transform for positioning elements.
+ *
+ * Uses the Visual Viewport API to get accurate measurements, especially important
+ * for mobile devices where virtual keyboards can change the visible area.
+ * Only updates state when values actually change to optimize performance.
+ *
+ * @returns An object containing viewport properties and a CSS transform string
+ */
+export declare function useWindowSize(): WindowSizeState;

package/dist/components/tiptap-editor/simple/i18n/en-US.json.d.ts

@@ -0,0 +1,107 @@
+declare const _default: {
+  "editor": {
+    "contentAriaLabel": "Main content area, start typing to enter text."
+  },
+  "toolbar": {
+    "add": "Add",
+    "undo": "Undo",
+    "redo": "Redo",
+    "heading": {
+      "label": "Heading",
+      "level": "Heading {{level}}"
+    },
+    "list": {
+      "label": "List",
+      "bullet": "Bullet List",
+      "ordered": "Ordered List",
+      "task": "Task List"
+    },
+    "blockquote": "Blockquote",
+    "codeBlock": "Code Block",
+    "marks": {
+      "bold": "Bold",
+      "italic": "Italic",
+      "strike": "Strike",
+      "code": "Code",
+      "underline": "Underline",
+      "superscript": "Superscript",
+      "subscript": "Subscript"
+    },
+    "highlight": {
+      "label": "Highlight",
+      "toggle": "Toggle highlight ({{color}})",
+      "remove": "Remove highlight",
+      "colors": {
+        "default": "Default background",
+        "gray": "Gray background",
+        "brown": "Brown background",
+        "orange": "Orange background",
+        "yellow": "Yellow background",
+        "green": "Green background",
+        "blue": "Blue background",
+        "purple": "Purple background",
+        "pink": "Pink background",
+        "red": "Red background"
+      }
+    },
+    "link": {
+      "label": "Link",
+      "placeholder": "Paste a link...",
+      "apply": "Apply link",
+      "open": "Open in new window",
+      "remove": "Remove link"
+    },
+    "align": {
+      "left": "Align left",
+      "center": "Align center",
+      "right": "Align right",
+      "justify": "Align justify"
+    },
+    "image": {
+      "label": "Add image"
+    },
+    "ai": {
+      "label": "AI Assistant",
+      "placeholder": "Ask AI to write something...",
+      "apiKeyPlaceholder": "sk-...",
+      "generate": "Generate",
+      "generating": "Generating...",
+      "insert": "Insert",
+      "replace": "Replace Selection",
+      "apiKeyLabel": "API Key (DeepSeek)",
+      "promptLabel": "Prompt",
+      "error": "Failed to generate content",
+      "optimizeSelection": "Selection Context: {{text}}",
+      "isWriting": "AI is writing",
+      "refinePlaceholder": "Tell AI what else needs to be changed...",
+      "tryAgain": "Try again",
+      "discard": "Discard",
+      "apply": "Apply",
+      "presets": {
+        "edit": "Edit",
+        "improve": "Improve writing",
+        "fix": "Fix spelling & grammar",
+        "shorter": "Make shorter",
+        "longer": "Make longer"
+      }
+    }
+  },
+  "imageUpload": {
+    "clickToUpload": "Click to upload",
+    "dragAndDrop": "or drag and drop",
+    "limitInfo": "Maximum {{limit}} file(s), {{size}}MB each.",
+    "uploading": "Uploading {{count}} files",
+    "clearAll": "Clear All",
+    "errors": {
+      "tooLarge": "File size exceeds maximum allowed ({{size}}MB)",
+      "limitExceeded": "Maximum {{limit}} files allowed",
+      "noFile": "No file selected",
+      "noFiles": "No files to upload",
+      "uploadFailed": "Upload failed",
+      "noUrl": "Upload failed: No URL returned"
+    }
+  }
+}
+;
+
+export default _default;

package/dist/components/tiptap-editor/simple/i18n/zh-CN.json.d.ts

@@ -0,0 +1,107 @@
+declare const _default: {
+  "editor": {
+    "contentAriaLabel": "主要内容区域，开始输入文字。"
+  },
+  "toolbar": {
+    "add": "添加",
+    "undo": "撤销",
+    "redo": "重做",
+    "heading": {
+      "label": "标题",
+      "level": "标题 {{level}}"
+    },
+    "list": {
+      "label": "列表",
+      "bullet": "无序列表",
+      "ordered": "有序列表",
+      "task": "任务列表"
+    },
+    "blockquote": "引用",
+    "codeBlock": "代码块",
+    "marks": {
+      "bold": "粗体",
+      "italic": "斜体",
+      "strike": "删除线",
+      "code": "行内代码",
+      "underline": "下划线",
+      "superscript": "上标",
+      "subscript": "下标"
+    },
+    "highlight": {
+      "label": "高亮",
+      "toggle": "切换高亮 ({{color}})",
+      "remove": "移除高亮",
+      "colors": {
+        "default": "默认背景",
+        "gray": "灰色背景",
+        "brown": "棕色背景",
+        "orange": "橙色背景",
+        "yellow": "黄色背景",
+        "green": "绿色背景",
+        "blue": "蓝色背景",
+        "purple": "紫色背景",
+        "pink": "粉色背景",
+        "red": "红色背景"
+      }
+    },
+    "link": {
+      "label": "链接",
+      "placeholder": "粘贴链接...",
+      "apply": "应用链接",
+      "open": "在新窗口打开",
+      "remove": "移除链接"
+    },
+    "align": {
+      "left": "左对齐",
+      "center": "居中对齐",
+      "right": "右对齐",
+      "justify": "两端对齐"
+    },
+    "image": {
+      "label": "添加图片"
+    },
+    "ai": {
+      "label": "AI 助手",
+      "placeholder": "让 AI 写点什么...",
+      "apiKeyPlaceholder": "sk-...",
+      "generate": "生成",
+      "generating": "生成中...",
+      "insert": "插入",
+      "replace": "替换选中内容",
+      "apiKeyLabel": "API Key (DeepSeek)",
+      "promptLabel": "提示词",
+      "error": "生成失败",
+      "optimizeSelection": "选中内容: {{text}}",
+      "isWriting": "AI 正在写作",
+      "refinePlaceholder": "告诉 AI 还需要修改什么...",
+      "tryAgain": "重试",
+      "discard": "放弃",
+      "apply": "应用",
+      "presets": {
+        "edit": "编辑",
+        "improve": "润色",
+        "fix": "修复拼写和语法",
+        "shorter": "缩短",
+        "longer": "扩写"
+      }
+    }
+  },
+  "imageUpload": {
+    "clickToUpload": "点击上传",
+    "dragAndDrop": "或拖拽上传",
+    "limitInfo": "最多 {{limit}} 个文件，每个 {{size}}MB。",
+    "uploading": "正在上传 {{count}} 个文件",
+    "clearAll": "全部清除",
+    "errors": {
+      "tooLarge": "文件大小超过限制 ({{size}}MB)",
+      "limitExceeded": "最多允许 {{limit}} 个文件",
+      "noFile": "未选择文件",
+      "noFiles": "没有可上传的文件",
+      "uploadFailed": "上传失败",
+      "noUrl": "上传失败：未返回 URL"
+    }
+  }
+}
+;
+
+export default _default;

package/dist/components/tiptap-editor/simple/index.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Simple Tiptap Editor
+ *
+ * A pre-configured Tiptap editor component with a simple toolbar and essential extensions.
+ * Includes support for:
+ * - Basic text formatting (Bold, Italic, Strike, Underline, etc.)
+ * - Headings (H1-H6)
+ * - Lists (Bullet, Ordered, Task)
+ * - Code blocks
+ * - Blockquotes
+ * - Links
+ * - Images (Upload & Display)
+ * - Text alignment
+ * - Undo/Redo
+ *
+ * @component
+ * @example
+ * ```tsx
+ * import SimpleEditor from "@/components/tiptap-editor/simple";
+ *
+ * function MyEditor() {
+ *   return (
+ *     <SimpleEditor />
+ *   );
+ * }
+ * ```
+ */
+export { SimpleEditor as default, SimpleEditor } from './simple-editor';

package/dist/components/tiptap-editor/simple/lib/ai-service.d.ts

@@ -0,0 +1,15 @@
+export interface AiCompletionOptions {
+    prompt: string;
+    systemPrompt?: string;
+    context?: string;
+    apiKey?: string;
+    baseUrl?: string;
+    model?: string;
+    onUpdate?: (text: string) => void;
+    signal?: AbortSignal;
+    headers?: Record<string, string>;
+    params?: Record<string, string>;
+    body?: Record<string, unknown>;
+    request?: (options: AiCompletionOptions) => Promise<string>;
+}
+export declare const generateAiContent: (options: AiCompletionOptions) => Promise<string>;