dishui 0.0.64 → 0.0.66

package/dist/components/pro/Calendar/utils.d.ts

@@ -0,0 +1,94 @@
+/**
+ * DishUI Calendar Component - Utility Functions
+ *
+ * Core date/time helpers, grid generation, and holiday resolution.
+ */
+import type { HolidayCalendar, HolidayEntry, CalendarLabels } from "./types";
+export declare const LABELS_EN: Required<CalendarLabels>;
+export declare const LABELS_ZH: Required<CalendarLabels>;
+/** Default entry color palette */
+export declare const DEFAULT_COLOR_OPTIONS: string[];
+/**
+ * Parse a YYYY-MM-DD string into a local Date at midnight.
+ * Returns null for invalid strings.
+ */
+export declare function parseDate(value: string | undefined | null): Date | null;
+/**
+ * Format a Date to YYYY-MM-DD string (local timezone).
+ */
+export declare function formatDate(date: Date): string;
+/**
+ * Get today's date as a YYYY-MM-DD string.
+ */
+export declare function todayStr(): string;
+/** Check if a Date is today */
+export declare function isToday(date: Date): boolean;
+/** Check if two Dates represent the same calendar day */
+export declare function isSameDay(a: Date, b: Date): boolean;
+/** Check if a Date falls on Saturday or Sunday */
+export declare function isWeekend(date: Date): boolean;
+/** Get the number of days in a given month (1-indexed month) */
+export declare function getDaysInMonth(year: number, month: number): number;
+/** Get the day-of-week (0 = Sun) of the 1st of a given month */
+export declare function getFirstDayOfMonth(year: number, month: number): number;
+/**
+ * Find a holiday entry for a given date string.
+ */
+export declare function getHolidayEntry(dateStr: string, holidays?: HolidayCalendar): HolidayEntry | undefined;
+/**
+ * Check if a date is a holiday (non-working day from the holiday calendar).
+ * Returns true for declared holidays (not compensatory workdays).
+ */
+export declare function isHoliday(dateStr: string, holidays?: HolidayCalendar): boolean;
+/**
+ * Check if a date is a non-working day considering the full holiday calendar.
+ * Priority: holiday entries > weekend check.
+ */
+export declare function isNonWorkingDay(date: Date, holidays?: HolidayCalendar): boolean;
+/**
+ * Generate a 42-cell (6 rows × 7 columns) grid for a month view.
+ * Each cell is a Date object. Includes leading/trailing days from
+ * the previous/next month to fill the grid.
+ */
+export declare function getMonthDates(year: number, month: number): Date[];
+/**
+ * Generate the 7 dates for a week containing the given date.
+ * Week starts on Sunday.
+ */
+export declare function getWeekDates(date: Date): Date[];
+/**
+ * Format minutes since midnight to HH:mm string.
+ */
+export declare function minutesToTime(minutes: number): string;
+/**
+ * Parse an HH:mm string to minutes since midnight.
+ * Returns 0 for invalid input.
+ */
+export declare function timeToMinutes(time: string | undefined): number;
+/**
+ * Format an HH:mm string for display (identity for now, but could localize).
+ */
+export declare function formatTime(time: string): string;
+/**
+ * Parse an HH:mm string — validates format, returns the string or empty.
+ */
+export declare function parseTime(time: string | undefined): string;
+/**
+ * Generate an array of time slot labels from 00:00 to 23:30 (30-minute intervals).
+ * Returns 48 items.
+ */
+export declare function generateTimeSlots(): string[];
+/** Cached time slots — always 48 items (00:00 through 23:30) */
+export declare const TIME_SLOTS: string[];
+/** Height of each 30-minute time slot in pixels */
+export declare const SLOT_HEIGHT = 28;
+/** Total height of the time grid (48 slots × SLOT_HEIGHT) */
+export declare const TIME_GRID_HEIGHT: number;
+/** Add N days to a date (returns new Date) */
+export declare function addDays(date: Date, days: number): Date;
+/** Generate a simple unique ID */
+export declare function generateId(): string;
+/**
+ * Clamp a number between min and max.
+ */
+export declare function clamp(value: number, min: number, max: number): number;

package/dist/components/pro/Chat/Chat.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import type { ChatProps } from './types';
+export declare function genChatMessageId(): string;
+declare const Chat: React.FC<ChatProps>;
+export default Chat;
+export { Chat };

package/dist/components/pro/Chat/index.d.ts

@@ -0,0 +1,2 @@
+export { default as Chat, genChatMessageId } from './Chat';
+export type { ChatProps, ChatMessage, ChatMessageMeta, ChatMessageContentType, ChatResourceItem, SlashCommand, SlashCommandContext, } from './types';

package/dist/components/pro/Chat/types.d.ts

@@ -0,0 +1,84 @@
+import type { ReactNode } from 'react';
+export type ChatMessageContentType = 'text' | 'markdown' | 'code' | 'resource' | 'interactive';
+export type ChatResourceItem = {
+    name: string;
+    url?: string;
+    kind?: string;
+};
+export type ChatMessageMeta = {
+    /** Used when `contentType` is `code` (CodeEditor `language` prop, e.g. `typescript`). */
+    language?: string;
+    resources?: ChatResourceItem[];
+    /** Renders in the bubble for `interactive` messages. */
+    interactiveNode?: ReactNode;
+    /** Custom slot for the entire bubble (overrides default body if set). */
+    render?: () => ReactNode;
+};
+export type ChatMessage = {
+    id: string;
+    role: 'user' | 'assistant';
+    content: string;
+    contentType?: ChatMessageContentType;
+    meta?: ChatMessageMeta;
+    /** Per-message avatar override. Can be a URL string or any ReactNode. */
+    avatar?: ReactNode | string;
+    /** Display name shown above the bubble (optional). */
+    nickname?: string;
+};
+export type SlashCommandContext = {
+    query: string;
+    close: () => void;
+    setInput: (v: string) => void;
+};
+export type SlashCommand = {
+    /** Triggers for `/name` (without leading slash in this field, e.g. `help` for `/help`) */
+    command: string;
+    title?: string;
+    description?: string;
+    /**
+     * Text to insert when the command is chosen, e.g. "/help ".
+     * Ignored if `onSelect` is provided.
+     */
+    insertText?: string;
+    onSelect?: (ctx: SlashCommandContext) => void;
+    /** Shown in the help panel next to the list, or in a small popover when provided. */
+    renderContent?: (ctx: SlashCommandContext) => ReactNode;
+};
+export type ChatProps = {
+    className?: string;
+    listClassName?: string;
+    composerClassName?: string;
+    inputPlaceholder?: string;
+    /** Fixed height of the chat container (CSS value). Defaults to `'520px'`. */
+    height?: string;
+    /** Custom avatar for the current user. Can be a URL string or any ReactNode. */
+    userAvatar?: ReactNode | string;
+    /** Custom avatar for the assistant. Can be a URL string or any ReactNode. */
+    assistantAvatar?: ReactNode | string;
+    /**
+     * Controlled: pass `messages` and `onMessagesChange`.
+     * If omitted, internal state is used and `defaultMessages` seeds it.
+     */
+    messages?: ChatMessage[];
+    onMessagesChange?: (next: ChatMessage[]) => void;
+    defaultMessages?: ChatMessage[];
+    /**
+     * Called after a user message is committed (it is already appended).
+     * `index` is the user message index in the updated array.
+     */
+    onMessageSend?: (message: ChatMessage, index: number, messages: ChatMessage[]) => void;
+    /**
+     * Called when an assistant message has been produced (sync or async flow).
+     * `index` is the assistant message index in the final array.
+     */
+    onAssistantMessageComplete?: (message: ChatMessage, index: number, messages: ChatMessage[]) => void;
+    /**
+     * Handle outgoing user text. Return one or more assistant messages, or void.
+     * When returning assistant messages, they are appended in order and each triggers `onAssistantMessageComplete`.
+     */
+    onSend?: (text: string, messages: ChatMessage[]) => void | Promise<ChatMessage | ChatMessage[] | void>;
+    /** `/help`-style command palette above the input. */
+    slashCommands?: SlashCommand[];
+    /** If false, the inline slash help panel is disabled. */
+    enableSlashMenu?: boolean;
+};