sparkdesign 0.0.1 → 0.2.6

package/dist/src/components/foundation/Switch/index.d.ts

@@ -0,0 +1,38 @@
+/**
+ * [INPUT]: (SwitchProps) - toggle 用 registry；segment 主库保留（含 FunctionSwitch）
+ * [OUTPUT]: (JSX.Element) - 布尔开关或分段切换
+ * [POS]: components/foundation/Switch
+ *
+ * variant=toggle：从 registry 再导出并包一层 data-style/data-theme。
+ * variant=segment：主库实现，默认图标用 registry icons-inline。
+ */
+import * as React from 'react';
+import type { SwitchProps as RegistrySwitchProps } from '../../../../registry/basic/switch';
+export type FunctionSwitchValue = 'code' | 'preview';
+export type FunctionSwitchSize = 'sm' | 'md';
+export interface SegmentOption {
+    value: string;
+    icon?: React.ReactNode;
+    label: string;
+}
+export interface SwitchProps extends Omit<RegistrySwitchProps, 'size'> {
+    variant?: 'toggle' | 'segment';
+    size?: 'md' | 'lg';
+    options?: SegmentOption[];
+    value?: string;
+    defaultValue?: string;
+    onValueChange?: (value: string) => void;
+    segmentSize?: FunctionSwitchSize;
+}
+declare const Switch: React.ForwardRefExoticComponent<SwitchProps & React.RefAttributes<HTMLDivElement>>;
+/** @deprecated 使用 <Switch variant="segment" /> 替代 */
+export interface FunctionSwitchProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    size?: FunctionSwitchSize;
+    value?: FunctionSwitchValue;
+    defaultValue?: FunctionSwitchValue;
+    onValueChange?: (value: FunctionSwitchValue) => void;
+    disabled?: boolean;
+}
+/** @deprecated 使用 <Switch variant="segment" value={...} onValueChange={...} /> 替代 */
+declare function FunctionSwitch({ size, value, defaultValue, onValueChange, disabled, className, ...rest }: FunctionSwitchProps): import("react/jsx-runtime").JSX.Element;
+export { Switch, FunctionSwitch };

package/dist/src/components/foundation/Table/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [INPUT]: (TableProps, TableHeaderProps 等)
+ * [OUTPUT]: (JSX.Element) - 表格，基于 Registry 单一来源
+ * [POS]: components/foundation/Table - 从 registry 再导出
+ */
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, } from '../../../../registry/basic/table';
+export type { TableProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeadProps, TableCellProps, TableCaptionProps, } from '../../../../registry/basic/table';

package/dist/src/components/foundation/Tabs/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [INPUT]: (TabsProps, TabsListProps, TabsTriggerProps, TabsContentProps)
+ * [OUTPUT]: (JSX.Element) - 标签页，基于 Registry 单一来源
+ * [POS]: components/foundation/Tabs - 从 registry 再导出
+ */
+export { Tabs, TabsList, TabsTrigger, TabsContent, tabsListVariants, tabsTriggerVariants, } from '../../../../registry/basic/tabs';
+export type { TabsProps, TabsListProps, TabsTriggerProps, TabsContentProps, } from '../../../../registry/basic/tabs';

package/dist/src/components/foundation/Tag/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * [INPUT]: (TagProps)
+ * [OUTPUT]: (JSX.Element) - 标签，基于 Registry 单一来源
+ * [POS]: components/foundation/Tag - 从 registry 再导出
+ *
+ * [PROTOCOL]:
+ * 1. 实现来自根目录 registry/basic/tag.tsx，主库仅 re-export
+ */
+export { Tag, tagVariants } from '../../../../registry/basic/tag';
+export type { TagProps } from '../../../../registry/basic/tag';

package/dist/src/components/foundation/Toast/index.d.ts

@@ -0,0 +1,12 @@
+import type { ToasterProps as RegistryToasterProps } from '../../../../registry/basic/sonner';
+export { toast } from 'sonner';
+export type ToasterProps = RegistryToasterProps & {
+    /** 显式传入 data-style，优先于 useThemeStyle */
+    dataStyle?: string;
+    /** 显式传入 data-theme，优先于 useThemeStyle */
+    dataTheme?: string;
+};
+export declare function Toaster({ theme, toastOptions, dataStyle: dataStyleProp, dataTheme: dataThemeProp, ...props }: ToasterProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Toaster {
+    var displayName: string;
+}

package/dist/src/components/foundation/Toggle/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [INPUT]: (ToggleProps, ToggleGroupProps, ToggleGroupItemProps)
+ * [OUTPUT]: (JSX.Element) - Toggle / ToggleGroup，基于 Registry 单一来源
+ * [POS]: components/foundation/Toggle - 从 registry 再导出
+ */
+export { Toggle, ToggleGroup, ToggleGroupItem, toggleVariants, } from '../../../../registry/basic/toggle';
+export type { ToggleProps, ToggleGroupProps, ToggleGroupItemProps, } from '../../../../registry/basic/toggle';

package/dist/src/components/foundation/Tooltip/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * [INPUT]: (TooltipProps，兼容 placement 与 side)
+ * [OUTPUT]: (JSX.Element) - 工具提示，基于 Registry 单一来源
+ * [POS]: components/foundation/Tooltip - 从 registry 再导出并兼容 placement
+ *
+ * [PROTOCOL]:
+ * 1. 实现来自根目录 registry/basic/tooltip.tsx；主库注入 useThemeStyle 使 Portal 随 ThemeStyleProvider
+ */
+import { TooltipProvider, TooltipRoot, TooltipTrigger, TooltipContent } from '../../../../registry/basic/tooltip';
+import type { TooltipProps as RegistryTooltipProps } from '../../../../registry/basic/tooltip';
+export { TooltipProvider, TooltipRoot, TooltipTrigger, TooltipContent };
+/** 对外 API：支持 placement（兼容旧用法）与 side（与 registry 一致） */
+export interface TooltipProps extends Omit<RegistryTooltipProps, 'side'> {
+    /** 弹出方向，与 side 二选一；推荐使用 side */
+    placement?: 'top' | 'right' | 'bottom' | 'left';
+    side?: 'top' | 'right' | 'bottom' | 'left';
+}
+export declare function Tooltip({ placement, side, ...props }: TooltipProps): import("react/jsx-runtime").JSX.Element;
+export declare namespace Tooltip {
+    var displayName: string;
+}

package/dist/src/components/foundation/Typography/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * [INPUT]: (Typography*Props)
+ * [OUTPUT]: (JSX.Element) - 排版组件，基于 Registry 单一来源
+ * [POS]: components/foundation/Typography - 从 registry 再导出
+ */
+export { TypographyH1, TypographyH2, TypographyH3, TypographyH4, TypographyP, TypographyBlockquote, TypographyTable, TypographyList, TypographyInlineCode, TypographyLead, TypographyLarge, TypographySmall, TypographyMuted, } from '../../../../registry/basic/typography';
+export type { TypographyH1Props, TypographyH2Props, TypographyH3Props, TypographyH4Props, TypographyPProps, TypographyBlockquoteProps, TypographyTableProps, TypographyListProps, TypographyInlineCodeProps, TypographyLeadProps, TypographyLargeProps, TypographySmallProps, TypographyMutedProps, } from '../../../../registry/basic/typography';

package/dist/src/components/index.d.ts

@@ -0,0 +1,136 @@
+/**
+ * [INPUT]: (N/A) - 此为导出入口文件，不接收输入
+ * [OUTPUT]: (Component & Type Exports) - 统一导出所有组件及其类型定义
+ * [POS]: components/index.ts - 组件库统一导出入口
+ *
+ * [PROTOCOL]:
+ * 1. 文件逻辑变更时必须同步更新此 Header
+ * 2. 更新后必须上浮检查 L2、L1 文档
+ * 3. 导出完整性检查：新增组件是否同步添加到导出列表
+ * 4. 类型导出检查：每个组件是否同时导出 Props 类型
+ *
+ * 注意：样式通过 Vite 构建配置自动处理，无需在此引入
+ */
+export { Button } from './foundation/Button';
+export type { ButtonProps } from './foundation/Button';
+export { IconButton } from './foundation/IconButton';
+export type { IconButtonProps } from './foundation/IconButton';
+export { Tooltip } from './foundation/Tooltip';
+export type { TooltipProps } from './foundation/Tooltip';
+export { EllipsisText } from './foundation/EllipsisText';
+export type { EllipsisTextProps } from './foundation/EllipsisText';
+export { OptionList } from './foundation/OptionList';
+export type { OptionListProps, OptionItem } from './foundation/OptionList';
+export { DropdownMenu, DropdownMenuTrigger, DropdownMenuContent, DropdownMenuItem, DropdownMenuCheckboxItem, DropdownMenuRadioItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuShortcut, DropdownMenuGroup, DropdownMenuPortal, DropdownMenuSub, DropdownMenuSubContent, DropdownMenuSubTrigger, DropdownMenuRadioGroup, } from './foundation/DropdownMenu';
+export type { DropdownMenuItemProps, DropdownMenuSubTriggerProps, DropdownMenuLabelProps, } from './foundation/DropdownMenu';
+export { AlertDialog, AlertDialogAction, AlertDialogCancel, AlertDialogContent, AlertDialogDescription, AlertDialogFooter, AlertDialogHeader, AlertDialogMedia, AlertDialogOverlay, AlertDialogPortal, AlertDialogTitle, AlertDialogTrigger, } from './foundation/AlertDialog';
+export type { AlertDialogContentProps, AlertDialogActionProps, AlertDialogHeaderProps, AlertDialogFooterProps, AlertDialogMediaProps, } from './foundation/AlertDialog';
+export { Kbd, KbdGroup } from './foundation/Kbd';
+export type { KbdProps, KbdGroupProps } from './foundation/Kbd';
+export { Switch, FunctionSwitch } from './foundation/Switch';
+export type { SwitchProps, FunctionSwitchProps, FunctionSwitchSize, FunctionSwitchValue, SegmentOption } from './foundation/Switch';
+export { Toggle, ToggleGroup, ToggleGroupItem } from './foundation/Toggle';
+export type { ToggleProps, ToggleGroupProps, ToggleGroupItemProps } from './foundation/Toggle';
+export { RadioGroup, RadioGroupItem } from './foundation/RadioGroup';
+export type { RadioGroupProps, RadioGroupItemProps } from './foundation/RadioGroup';
+export { CollapsibleSection } from './foundation/CollapsibleSection';
+export type { CollapsibleSectionProps } from './foundation/CollapsibleSection';
+export { Collapsible, CollapsibleTrigger, CollapsibleContent } from './foundation/Collapsible';
+export { ResizablePanelGroup, ResizablePanel, ResizableHandle, } from './foundation/Resizable';
+export type { ResizablePanelGroupProps, ResizablePanelProps, ResizableHandleProps, } from './foundation/Resizable';
+export { Scrollbar } from './foundation/Scrollbar';
+export type { ScrollbarProps } from './foundation/Scrollbar';
+export { Skeleton } from './foundation/Skeleton';
+export type { SkeletonProps } from './foundation/Skeleton';
+export { Spinner } from './foundation/Spinner';
+export type { SpinnerProps } from './foundation/Spinner';
+export { Table, TableHeader, TableBody, TableFooter, TableHead, TableRow, TableCell, TableCaption, } from './foundation/Table';
+export type { TableProps, TableHeaderProps, TableBodyProps, TableFooterProps, TableRowProps, TableHeadProps, TableCellProps, TableCaptionProps, } from './foundation/Table';
+export { Avatar, AvatarImage, AvatarFallback, AvatarBadge, AvatarGroup, AvatarGroupCount, } from './foundation/Avatar';
+export type { AvatarProps, AvatarImageProps, AvatarFallbackProps, AvatarBadgeProps, AvatarGroupProps, AvatarGroupCountProps, } from './foundation/Avatar';
+export { Toaster, toast } from './foundation/Toast';
+export type { ToasterProps } from './foundation/Toast';
+export { Select, SelectTrigger, SelectValue, SelectContent, SelectLabel, SelectSeparator, SelectGroup, SelectItem, SelectScrollUpButton, SelectScrollDownButton, } from './foundation/Select';
+export type { SelectProps, SelectTriggerProps, SelectValueProps, SelectContentProps, SelectLabelProps, SelectSeparatorProps, SelectGroupProps, SelectItemProps, } from './foundation/Select';
+export { Tabs, TabsList, TabsTrigger, TabsContent, } from './foundation/Tabs';
+export type { TabsProps, TabsListProps, TabsTriggerProps, TabsContentProps, } from './foundation/Tabs';
+export { Collapse, CollapseItem, CollapseTrigger, CollapseContent, } from './foundation/Collapse';
+export type { CollapseProps, CollapseItemProps, CollapseTriggerProps, CollapseContentProps, } from './foundation/Collapse';
+export { TypographyH1, TypographyH2, TypographyH3, TypographyH4, TypographyP, TypographyBlockquote, TypographyTable, TypographyList, TypographyInlineCode, TypographyLead, TypographyLarge, TypographySmall, TypographyMuted, } from './foundation/Typography';
+export type { TypographyH1Props, TypographyH2Props, TypographyH3Props, TypographyH4Props, TypographyPProps, TypographyBlockquoteProps, TypographyTableProps, TypographyListProps, TypographyInlineCodeProps, TypographyLeadProps, TypographyLargeProps, TypographySmallProps, TypographyMutedProps, } from './foundation/Typography';
+export { Slider } from './foundation/Slider';
+export type { SliderProps } from './foundation/Slider';
+export { Pagination, PaginationContent, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PaginationEllipsis, } from './foundation/Pagination';
+export type { PaginationLinkProps, PaginationPreviousProps, PaginationNextProps, } from './foundation/Pagination';
+export { Tag, tagVariants } from './foundation/Tag';
+export type { TagProps } from './foundation/Tag';
+export { CollapsibleCard } from './chat/CollapsibleCard';
+export type { CollapsibleCardProps } from './chat/CollapsibleCard';
+export { FolderButton } from './chat/FolderButton';
+export type { FolderButtonProps } from './chat/FolderButton';
+export { ChatInput, ChatInputRoot, ChatInputAbove, ChatInputBox, ChatInputAttachments, ChatInputInput, ChatInputActions, ChatInputActionsLeft, ChatInputActionsRight, ChatInputExpandButton, ChatInputFolderButton, ChatInputMoreButton, ChatInputSendButton, ChatInputFooterLeft, } from './chat/ChatInput';
+export type { ChatInputProps, FolderPermissionConfig, GenerationStatusConfig, FooterLeftModelSwitchConfig, FooterLeftModelSwitchItem, ChatInputRootProps, ChatInputAboveProps, ChatInputBoxProps, ChatInputAttachmentsProps, ChatInputInputProps, ChatInputActionsProps, ChatInputActionsLeftProps, ChatInputActionsRightProps, ChatInputExpandButtonProps, } from './chat/ChatInput';
+export { RelatedPrompts } from './chat/RelatedPrompts';
+export type { RelatedPromptsProps, RelatedPromptItem } from './chat/RelatedPrompts';
+export { SuggestionPart } from './chat/SuggestionPart';
+export type { SuggestionPartProps } from './chat/SuggestionPart';
+export { SendButton } from './chat/SendButton';
+export type { SendButtonProps } from './chat/SendButton';
+export { Response } from './chat/Response';
+export type { ResponseProps, ResponsePhase, ResponseRound, ResponseStep, ResponseStepToolType } from './chat/Response';
+export { Request } from './chat/Request';
+export type { RequestProps } from './chat/Request';
+export { FileCard } from './chat/FileCard';
+export type { FileCardProps } from './chat/FileCard';
+export { FileAttachment } from './chat/FileAttachment';
+export type { FileAttachmentProps } from './chat/FileAttachment';
+export { ImageAttachment } from './chat/ImageAttachment';
+export type { ImageAttachmentProps } from './chat/ImageAttachment';
+export { ReasoningStep } from './chat/ReasoningStep';
+export type { ReasoningStepProps, ReasoningStepDetail } from './chat/ReasoningStep';
+export { ToolInvocationCard } from './chat/ToolInvocationCard';
+export type { ToolInvocationCardProps, ToolInvocationStatus } from './chat/ToolInvocationCard';
+export { PermissionCard } from './chat/PermissionCard';
+export type { PermissionCardProps, PermissionCardAction } from './chat/PermissionCard';
+export { MarkdownBody } from './chat/Markdown';
+export type { MarkdownBodyProps } from './chat/Markdown';
+export { GenerationStatusBar } from './chat/GenerationStatusBar';
+export type { GenerationStatusBarProps } from './chat/GenerationStatusBar';
+export { ThinkingIndicator } from './chat/ThinkingIndicator';
+export type { ThinkingIndicatorProps } from './chat/ThinkingIndicator';
+export { ImageGenerating } from './chat/ImageGenerating';
+export type { ImageGeneratingProps } from './chat/ImageGenerating';
+export { SidebarMenu } from './chat/SidebarMenu';
+export type { SidebarMenuProps, SidebarMenuItem, SidebarMenuItemAction } from './chat/SidebarMenu';
+export { GeneratedImagesGrid } from './chat/GeneratedImagesGrid';
+export type { GeneratedImagesGridProps } from './chat/GeneratedImagesGrid';
+export { UserQuestion } from './chat/UserQuestion';
+export type { UserQuestionProps, UserQuestionHandle, UserQuestionItem, UserQuestionOption, UserQuestionLabels, } from './chat/UserQuestion';
+export { UserQuestionAnswer } from './chat/UserQuestionAnswer';
+export type { UserQuestionAnswerProps, UserQuestionAnswerLabels, } from './chat/UserQuestionAnswer';
+export { QueueIndicator } from './chat/QueueIndicator';
+export type { QueueIndicatorProps, QueueIndicatorItem, QueueIndicatorLabels, } from './chat/QueueIndicator';
+export { FileReviewPart } from './chat/FileReviewPart';
+export type { FileReviewPartProps, FileReviewFile } from './chat/FileReviewPart';
+export { TaskPart } from './chat/TaskPart';
+export type { TaskPartProps, TaskPartTask, TaskStatus } from './chat/TaskPart';
+export { PlanPart } from './chat/PlanPart';
+export type { PlanPartProps } from './chat/PlanPart';
+export { MermaidPart } from './chat/MermaidPart';
+export type { MermaidPartProps } from './chat/MermaidPart';
+export { CodeBlockPart } from './chat/CodeBlockPart';
+export type { CodeBlockPartProps, CodeBlockDiffType } from './chat/CodeBlockPart';
+export { TerminalCodeBlockPart } from './chat/TerminalCodeBlockPart';
+export type { TerminalCodeBlockPartProps } from './chat/TerminalCodeBlockPart';
+export { BrowserUsePart } from './chat/BrowserUsePart';
+export type { BrowserUsePartProps, BrowserUseStatus } from './chat/BrowserUsePart';
+export { QuestionPart } from './chat/QuestionPart';
+export type { QuestionPartProps } from './chat/QuestionPart';
+export { Progress } from './foundation/Progress';
+export type { ProgressProps } from './foundation/Progress';
+export { IconsProvider, useIcons, useIcon } from '../icons/context';
+export type { IconKey, IconComponent, IconProps } from '../icons/types';
+export type { IconsContextValue } from '../icons/context';
+export { ThemeStyleProvider, useThemeStyle, type ThemeStyleValue, } from '../lib/ThemeStyleContext';
+export { MOTION_DURATION, MOTION_EASE, MOTION_SPRING } from '../lib/motion';
+export { FILE_TYPE_MAP, SETI_CHAR_MAP, SETI_COLOR_MAP, TYPE_TO_TOKEN_CLASS, getSetiIconType, getSetiIcon, getSetiIconColor, getFileIconColorClass, } from '../lib';

package/dist/src/icons/context.d.ts

@@ -0,0 +1,26 @@
+/**
+ * [INPUT]: (IconsProviderProps) - 图标映射与可选 getFileIcon
+ * [OUTPUT]: (JSX.Element) - Provider 包裹子节点；useIcon 无配置时返回 undefined，便于 ?? 走内置 fallback
+ * [POS]: icons/context - 图标注入层，组件通过 useIcons() 取图标，用户可替换为 Lucide/Remix 等
+ *
+ * [PROTOCOL]:
+ * 1. 新增 IconKey 时同步 types.ts
+ * 2. 不依赖 @ali/qoder-icon，主库零图标依赖
+ * 3. useIcon 无图标时返回 undefined，主库直接渲染处需 ?? 内置 SVG（如 CollapsibleSection、Toast）
+ */
+import { type ReactNode } from 'react';
+import type { IconKey, IconComponent } from './types';
+export interface IconsContextValue {
+    /** 语义化图标映射，未提供时组件内使用占位 */
+    icons: Partial<Record<IconKey, IconComponent>>;
+    /** 可选：按文件名返回文件类型图标，未提供时 file-icon 使用通用占位 */
+    getFileIcon?: (filename: string, className?: string) => ReactNode;
+}
+export interface IconsProviderProps {
+    value: IconsContextValue;
+    children: ReactNode;
+}
+export declare function IconsProvider({ value, children }: IconsProviderProps): import("react/jsx-runtime").JSX.Element;
+export declare function useIcons(): IconsContextValue;
+/** 渲染语义化图标：有则用传入的 Icon，无则返回 undefined，便于调用方用 ?? 走内置 SVG fallback */
+export declare function useIcon(key: IconKey, className?: string): ReactNode;

package/dist/src/icons/types.d.ts

@@ -0,0 +1,18 @@
+/**
+ * [INPUT]: N/A - 类型定义
+ * [OUTPUT]: IconKey, IconComponent 等类型
+ * [POS]: icons/types - 图标抽象层类型，供 IconsContext 与组件使用
+ *
+ * [PROTOCOL]:
+ * 1. 新增组件使用图标时在此补充语义化 key
+ * 2. 与 IconsContext 的默认实现（若有）保持同步
+ */
+import type { ComponentType } from 'react';
+/** 图标组件通用 props（支持 className 与无障碍） */
+export interface IconProps {
+    className?: string;
+    'aria-hidden'?: boolean;
+}
+/** 语义化图标 key：库内组件通过 useIcons() 按 key 取图标，用户可用任意图标库实现 */
+export type IconKey = 'send' | 'stop' | 'mic' | 'addLarge' | 'folder' | 'folderOpen' | 'history' | 'folderFill' | 'close' | 'closeLarge' | 'arrowRight' | 'arrowLeft' | 'codeSlash' | 'eye' | 'warning' | 'arrowDown' | 'arrowUp' | 'checkboxCircle' | 'closeCircle' | 'time' | 'chat' | 'chat3' | 'chat4' | 'sparkling' | 'questionAnswer' | 'infinity' | 'more' | 'arrowDownS' | 'arrowUpS' | 'check' | 'checkLine' | 'loader' | 'arrowRightCircleFill' | 'requestChanges' | 'catalog' | 'circle' | 'indeterminateCircle' | 'fileList2' | 'download' | 'questionnaire' | 'terminalBox' | 'externalLink' | 'global' | 'forbid2';
+export type IconComponent = ComponentType<IconProps>;

package/dist/src/lib/ThemeStyleContext.d.ts

@@ -0,0 +1,21 @@
+/**
+ * [INPUT]: (N/A) - Context 由上层 Provider 注入
+ * [OUTPUT]: (React Context) - 供 Portal 浮层继承 data-style / data-theme
+ * [POS]: lib/ThemeStyleContext
+ *
+ * [PROTOCOL]:
+ * 1. 用于 DropdownMenu、Tooltip 等挂到 body 的浮层，使其与当前页面的 data-style/data-theme 一致
+ * 2. 应用层在根节点用 ThemeStyleProvider 包裹并传入 style/theme，浮层内组件通过 useThemeStyle 读取并包一层 div
+ */
+import { type ReactNode } from 'react';
+export interface ThemeStyleValue {
+    /** 布局风格：neutral | compact | soft | sharp | dense，对应 scale.css */
+    style?: string;
+    /** 颜色主题：light | dark | custom，对应 theme.css */
+    theme?: string;
+}
+export declare function ThemeStyleProvider({ children, value, }: {
+    children: ReactNode;
+    value: ThemeStyleValue;
+}): import("react/jsx-runtime").JSX.Element;
+export declare function useThemeStyle(): ThemeStyleValue;

package/dist/src/lib/file-icon.d.ts

@@ -0,0 +1,16 @@
+/**
+ * [INPUT]: (filename: string, className?: string) - 文件名、图标样式类
+ * [OUTPUT]: (ReactNode) - 对应文件类型的图标（默认通用占位；可通过 IconsProvider.getFileIcon 注入自定义）
+ * [POS]: lib/file-icon - 文件图标工具，用于 FileCard 等
+ *
+ * [PROTOCOL]:
+ * 1. 文件逻辑变更时必须同步更新此 Header
+ * 2. 使用方通过 IconsProvider 的 getFileIcon 注入时可实现按扩展名映射（如 Lucide/Remix）
+ * 3. 主库不依赖任何闭源图标包
+ */
+import type { ReactNode } from 'react';
+/**
+ * 根据文件名返回文件图标。
+ * 主库仅提供通用占位图标；用户通过 IconsProvider 传入 getFileIcon 时可实现按扩展名映射（如 Lucide、Remix）。
+ */
+export declare function getFileIconByFilename(filename: string, className?: string): ReactNode;

package/dist/src/lib/i18n.d.ts

@@ -0,0 +1,12 @@
+/**
+ * [INPUT]: () - 无输入
+ * [OUTPUT]: (void) - 初始化 i18next 实例，供 react-i18next 使用
+ * [POS]: lib/i18n.ts - 在应用入口最早导入，确保 useTranslation 可用
+ *
+ * [PROTOCOL]:
+ * 1. 文件逻辑变更时必须同步更新此 Header
+ * 2. 新增语言或翻译时在此扩展 resources
+ * 3. 当前仅英文：lng/fallbackLng 为 en；业务侧可通过 props 传入 t() 做多语言
+ */
+import i18n from 'i18next';
+export default i18n;

package/dist/src/lib/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * [INPUT]: (N/A) - Lib 工具函数导出入口
+ * [OUTPUT]: (Utility Exports) - 统一导出所有工具函数
+ * [POS]: lib/index.ts
+ */
+export { getFileIconByFilename } from './file-icon';
+export { FILE_TYPE_MAP, SETI_CHAR_MAP, SETI_COLOR_MAP, TYPE_TO_TOKEN_CLASS, getSetiIconType, getSetiIcon, getSetiIconColor, getFileIconColorClass, } from '../../registry/lib/file-icon-maps';
+export { default as i18n } from './i18n';
+export { ThemeStyleProvider, useThemeStyle, type ThemeStyleValue, } from './ThemeStyleContext';
+export { MOTION_DURATION, MOTION_EASE, MOTION_SPRING } from './motion';

package/dist/src/lib/motion.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Shared motion baseline for foundation components shown in showcase.
+ * Keep values centralized to make interaction rhythm consistent.
+ */
+export declare const MOTION_DURATION: {
+    readonly fast: 0.15;
+    readonly base: 0.2;
+    readonly slow: 0.3;
+};
+export declare const MOTION_EASE: {
+    readonly standard: readonly [0.16, 1, 0.3, 1];
+    readonly emphasized: readonly [0.2, 0.8, 0.2, 1];
+    readonly out: readonly [0, 0, 0.2, 1];
+};
+export declare const MOTION_SPRING: {
+    readonly snappy: {
+        readonly type: "spring";
+        readonly stiffness: 520;
+        readonly damping: 34;
+        readonly mass: 0.7;
+    };
+};

package/dist/src/lib/utils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * [INPUT]: (ClassValue[])
+ * [OUTPUT]: (string) - 合并后的 class 名
+ * [POS]: lib/utils.ts - 供主库与 registry 引用（@/lib/utils）
+ *
+ * [PROTOCOL]:
+ * 1. 与 registry/lib/utils 保持一致，供从 registry 引入的组件解析
+ * 2. 使用 clsx + tailwind-merge 合并类名
+ */
+import { type ClassValue } from 'clsx';
+export declare function cn(...inputs: ClassValue[]): string;

package/dist/stateDiagram-FKZM4ZOC-DBvJ_eeL.cjs

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const S=require("./chunk-DI55MBZ5-D1YJMs6x.cjs"),t=require("./mermaid.core-DBwAx_jp.cjs"),T=require("./graph-DIbblrZP.cjs"),H=require("./layout-Byuh8f-J.cjs");var z=t.__name(e=>e.append("circle").attr("class","start-state").attr("r",t.getConfig2().state.sizeUnit).attr("cx",t.getConfig2().state.padding+t.getConfig2().state.sizeUnit).attr("cy",t.getConfig2().state.padding+t.getConfig2().state.sizeUnit),"drawStartState"),L=t.__name(e=>e.append("line").style("stroke","grey").style("stroke-dasharray","3").attr("x1",t.getConfig2().state.textHeight).attr("class","divider").attr("x2",t.getConfig2().state.textHeight*2).attr("y1",0).attr("y2",0),"drawDivider"),A=t.__name((e,n)=>{const d=e.append("text").attr("x",2*t.getConfig2().state.padding).attr("y",t.getConfig2().state.textHeight+2*t.getConfig2().state.padding).attr("font-size",t.getConfig2().state.fontSize).attr("class","state-title").text(n.id),g=d.node().getBBox();return e.insert("rect",":first-child").attr("x",t.getConfig2().state.padding).attr("y",t.getConfig2().state.padding).attr("width",g.width+2*t.getConfig2().state.padding).attr("height",g.height+2*t.getConfig2().state.padding).attr("rx",t.getConfig2().state.radius),d},"drawSimpleState"),P=t.__name((e,n)=>{const d=t.__name(function(c,m,y){const b=c.append("tspan").attr("x",2*t.getConfig2().state.padding).text(m);y||b.attr("dy",t.getConfig2().state.textHeight)},"addTspan"),o=e.append("text").attr("x",2*t.getConfig2().state.padding).attr("y",t.getConfig2().state.textHeight+1.3*t.getConfig2().state.padding).attr("font-size",t.getConfig2().state.fontSize).attr("class","state-title").text(n.descriptions[0]).node().getBBox(),l=o.height,p=e.append("text").attr("x",t.getConfig2().state.padding).attr("y",l+t.getConfig2().state.padding*.4+t.getConfig2().state.dividerMargin+t.getConfig2().state.textHeight).attr("class","state-description");let i=!0,r=!0;n.descriptions.forEach(function(c){i||(d(p,c,r),r=!1),i=!1});const C=e.append("line").attr("x1",t.getConfig2().state.padding).attr("y1",t.getConfig2().state.padding+l+t.getConfig2().state.dividerMargin/2).attr("y2",t.getConfig2().state.padding+l+t.getConfig2().state.dividerMargin/2).attr("class","descr-divider"),h=p.node().getBBox(),s=Math.max(h.width,o.width);return C.attr("x2",s+3*t.getConfig2().state.padding),e.insert("rect",":first-child").attr("x",t.getConfig2().state.padding).attr("y",t.getConfig2().state.padding).attr("width",s+2*t.getConfig2().state.padding).attr("height",h.height+l+2*t.getConfig2().state.padding).attr("rx",t.getConfig2().state.radius),e},"drawDescrState"),R=t.__name((e,n,d)=>{const g=t.getConfig2().state.padding,o=2*t.getConfig2().state.padding,l=e.node().getBBox(),p=l.width,i=l.x,r=e.append("text").attr("x",0).attr("y",t.getConfig2().state.titleShift).attr("font-size",t.getConfig2().state.fontSize).attr("class","state-title").text(n.id),h=r.node().getBBox().width+o;let s=Math.max(h,p);s===p&&(s=s+o);let c;const m=e.node().getBBox();n.doc,c=i-g,h>p&&(c=(p-s)/2+g),Math.abs(i-m.x)<g&&h>p&&(c=i-(h-p)/2);const y=1-t.getConfig2().state.textHeight;return e.insert("rect",":first-child").attr("x",c).attr("y",y).attr("class",d?"alt-composit":"composit").attr("width",s).attr("height",m.height+t.getConfig2().state.textHeight+t.getConfig2().state.titleShift+1).attr("rx","0"),r.attr("x",c+g),h<=p&&r.attr("x",i+(s-o)/2-h/2+g),e.insert("rect",":first-child").attr("x",c).attr("y",t.getConfig2().state.titleShift-t.getConfig2().state.textHeight-t.getConfig2().state.padding).attr("width",s).attr("height",t.getConfig2().state.textHeight*3).attr("rx",t.getConfig2().state.radius),e.insert("rect",":first-child").attr("x",c).attr("y",t.getConfig2().state.titleShift-t.getConfig2().state.textHeight-t.getConfig2().state.padding).attr("width",s).attr("height",m.height+3+2*t.getConfig2().state.textHeight).attr("rx",t.getConfig2().state.radius),e},"addTitleAndBox"),W=t.__name(e=>(e.append("circle").attr("class","end-state-outer").attr("r",t.getConfig2().state.sizeUnit+t.getConfig2().state.miniPadding).attr("cx",t.getConfig2().state.padding+t.getConfig2().state.sizeUnit+t.getConfig2().state.miniPadding).attr("cy",t.getConfig2().state.padding+t.getConfig2().state.sizeUnit+t.getConfig2().state.miniPadding),e.append("circle").attr("class","end-state-inner").attr("r",t.getConfig2().state.sizeUnit).attr("cx",t.getConfig2().state.padding+t.getConfig2().state.sizeUnit+2).attr("cy",t.getConfig2().state.padding+t.getConfig2().state.sizeUnit+2)),"drawEndState"),G=t.__name((e,n)=>{let d=t.getConfig2().state.forkWidth,g=t.getConfig2().state.forkHeight;if(n.parentId){let o=d;d=g,g=o}return e.append("rect").style("stroke","black").style("fill","black").attr("width",d).attr("height",g).attr("x",t.getConfig2().state.padding).attr("y",t.getConfig2().state.padding)},"drawForkJoinState"),D=t.__name((e,n,d,g)=>{let o=0;const l=g.append("text");l.style("text-anchor","start"),l.attr("class","noteText");let p=e.replace(/\r\n/g,"<br/>");p=p.replace(/\n/g,"<br/>");const i=p.split(t.common_default.lineBreakRegex);let r=1.25*t.getConfig2().state.noteMargin;for(const C of i){const h=C.trim();if(h.length>0){const s=l.append("tspan");if(s.text(h),r===0){const c=s.node().getBBox();r+=c.height}o+=r,s.attr("x",n+t.getConfig2().state.noteMargin),s.attr("y",d+o+1.25*t.getConfig2().state.noteMargin)}}return{textWidth:l.node().getBBox().width,textHeight:o}},"_drawLongText"),U=t.__name((e,n)=>{n.attr("class","state-note");const d=n.append("rect").attr("x",0).attr("y",t.getConfig2().state.padding),g=n.append("g"),{textWidth:o,textHeight:l}=D(e,0,0,g);return d.attr("height",l+2*t.getConfig2().state.noteMargin),d.attr("width",o+t.getConfig2().state.noteMargin*2),d},"drawNote"),k=t.__name(function(e,n){const d=n.id,g={id:d,label:n.id,width:0,height:0},o=e.append("g").attr("id",d).attr("class","stateGroup");n.type==="start"&&z(o),n.type==="end"&&W(o),(n.type==="fork"||n.type==="join")&&G(o,n),n.type==="note"&&U(n.note.text,o),n.type==="divider"&&L(o),n.type==="default"&&n.descriptions.length===0&&A(o,n),n.type==="default"&&n.descriptions.length>0&&P(o,n);const l=o.node().getBBox();return g.width=l.width+2*t.getConfig2().state.padding,g.height=l.height+2*t.getConfig2().state.padding,g},"drawState"),N=0,F=t.__name(function(e,n,d){const g=t.__name(function(r){switch(r){case S.StateDB.relationType.AGGREGATION:return"aggregation";case S.StateDB.relationType.EXTENSION:return"extension";case S.StateDB.relationType.COMPOSITION:return"composition";case S.StateDB.relationType.DEPENDENCY:return"dependency"}},"getRelationType");n.points=n.points.filter(r=>!Number.isNaN(r.y));const o=n.points,l=t.line().x(function(r){return r.x}).y(function(r){return r.y}).curve(t.curveBasis),p=e.append("path").attr("d",l(o)).attr("id","edge"+N).attr("class","transition");let i="";if(t.getConfig2().state.arrowMarkerAbsolute&&(i=t.getUrl(!0)),p.attr("marker-end","url("+i+"#"+g(S.StateDB.relationType.DEPENDENCY)+"End)"),d.title!==void 0){const r=e.append("g").attr("class","stateLabel"),{x:C,y:h}=t.utils_default.calcLabelPosition(n.points),s=t.common_default.getRows(d.title);let c=0;const m=[];let y=0,b=0;for(let x=0;x<=s.length;x++){const f=r.append("text").attr("text-anchor","middle").text(s[x]).attr("x",C).attr("y",h+c),u=f.node().getBBox();y=Math.max(y,u.width),b=Math.min(b,u.x),t.log.info(u.x,C,h+c),c===0&&(c=f.node().getBBox().height,t.log.info("Title height",c,h)),m.push(f)}let _=c*s.length;if(s.length>1){const x=(s.length-1)*c*.5;m.forEach((f,u)=>f.attr("y",h+u*c-x)),_=c*s.length}const a=r.node().getBBox();r.insert("rect",":first-child").attr("class","box").attr("x",C-y/2-t.getConfig2().state.padding/2).attr("y",h-_/2-t.getConfig2().state.padding/2-3.5).attr("width",y+t.getConfig2().state.padding).attr("height",_+t.getConfig2().state.padding),t.log.info(a)}N++},"drawEdge"),w,E={},O=t.__name(function(){},"setConf"),q=t.__name(function(e){e.append("defs").append("marker").attr("id","dependencyEnd").attr("refX",19).attr("refY",7).attr("markerWidth",20).attr("markerHeight",28).attr("orient","auto").append("path").attr("d","M 19,7 L9,13 L14,7 L9,1 Z")},"insertMarkers"),J=t.__name(function(e,n,d,g){w=t.getConfig2().state;const o=t.getConfig2().securityLevel;let l;o==="sandbox"&&(l=t.select("#i"+n));const p=o==="sandbox"?t.select(l.nodes()[0].contentDocument.body):t.select("body"),i=o==="sandbox"?l.nodes()[0].contentDocument:document;t.log.debug("Rendering diagram "+e);const r=p.select(`[id='${n}']`);q(r);const C=g.db.getRootDoc();M(C,r,void 0,!1,p,i,g);const h=w.padding,s=r.node().getBBox(),c=s.width+h*2,m=s.height+h*2,y=c*1.75;t.configureSvgSize(r,m,y,w.useMaxWidth),r.attr("viewBox",`${s.x-w.padding}  ${s.y-w.padding} `+c+" "+m)},"draw"),X=t.__name(e=>e?e.length*w.fontSizeFactor:1,"getLabelWidth"),M=t.__name((e,n,d,g,o,l,p)=>{const i=new T.Graph({compound:!0,multigraph:!0});let r,C=!0;for(r=0;r<e.length;r++)if(e[r].stmt==="relation"){C=!1;break}d?i.setGraph({rankdir:"LR",multigraph:!0,compound:!0,ranker:"tight-tree",ranksep:C?1:w.edgeLengthFactor,nodeSep:C?1:50,isMultiGraph:!0}):i.setGraph({rankdir:"TB",multigraph:!0,compound:!0,ranksep:C?1:w.edgeLengthFactor,nodeSep:C?1:50,ranker:"tight-tree",isMultiGraph:!0}),i.setDefaultEdgeLabel(function(){return{}});const h=p.db.getStates(),s=p.db.getRelations(),c=Object.keys(h);for(const a of c){const x=h[a];d&&(x.parentId=d);let f;if(x.doc){let u=n.append("g").attr("id",x.id).attr("class","stateGroup");f=M(x.doc,u,x.id,!g,o,l,p);{u=R(u,x,g);let B=u.node().getBBox();f.width=B.width,f.height=B.height+w.padding/2,E[x.id]={y:w.compositTitleSize}}}else f=k(n,x,i);if(x.note){const u={descriptions:[],id:x.id+"-note",note:x.note,type:"note"},B=k(n,u,i);x.note.position==="left of"?(i.setNode(f.id+"-note",B),i.setNode(f.id,f)):(i.setNode(f.id,f),i.setNode(f.id+"-note",B)),i.setParent(f.id,f.id+"-group"),i.setParent(f.id+"-note",f.id+"-group")}else i.setNode(f.id,f)}t.log.debug("Count=",i.nodeCount(),i);let m=0;s.forEach(function(a){m++,t.log.debug("Setting edge",a),i.setEdge(a.id1,a.id2,{relation:a,width:X(a.title),height:w.labelHeight*t.common_default.getRows(a.title).length,labelpos:"c"},"id"+m)}),H.layout(i),t.log.debug("Graph after layout",i.nodes());const y=n.node();i.nodes().forEach(function(a){a!==void 0&&i.node(a)!==void 0?(t.log.warn("Node "+a+": "+JSON.stringify(i.node(a))),o.select("#"+y.id+" #"+a).attr("transform","translate("+(i.node(a).x-i.node(a).width/2)+","+(i.node(a).y+(E[a]?E[a].y:0)-i.node(a).height/2)+" )"),o.select("#"+y.id+" #"+a).attr("data-x-shift",i.node(a).x-i.node(a).width/2),l.querySelectorAll("#"+y.id+" #"+a+" .divider").forEach(f=>{const u=f.parentElement;let B=0,v=0;u&&(u.parentElement&&(B=u.parentElement.getBBox().width),v=parseInt(u.getAttribute("data-x-shift"),10),Number.isNaN(v)&&(v=0)),f.setAttribute("x1",0-v+8),f.setAttribute("x2",B-v-8)})):t.log.debug("No Node "+a+": "+JSON.stringify(i.node(a)))});let b=y.getBBox();i.edges().forEach(function(a){a!==void 0&&i.edge(a)!==void 0&&(t.log.debug("Edge "+a.v+" -> "+a.w+": "+JSON.stringify(i.edge(a))),F(n,i.edge(a),i.edge(a).relation))}),b=y.getBBox();const _={id:d||"root",label:d||"root",width:0,height:0};return _.width=b.width+2*w.padding,_.height=b.height+2*w.padding,t.log.debug("Doc rendered",_,i),_},"renderDoc"),I={setConf:O,draw:J},Y={parser:S.stateDiagram_default,get db(){return new S.StateDB(1)},renderer:I,styles:S.styles_default,init:t.__name(e=>{e.state||(e.state={}),e.state.arrowMarkerAbsolute=e.arrowMarkerAbsolute},"init")};exports.diagram=Y;