@h-ai/ui 0.1.0-alpha5

package/dist/components/scenes/storage/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * @h-ai/ui — Storage 场景组件导出
+ *
+ * 存储相关的场景化组件
+ * @module index
+ */
+export { default as AvatarUpload } from './AvatarUpload.svelte';
+export { default as FileList } from './FileList.svelte';
+export { default as FileUpload } from './FileUpload.svelte';
+export { default as ImageUpload } from './ImageUpload.svelte';

package/dist/components/scenes/storage/index.js

@@ -0,0 +1,12 @@
+/**
+ * @h-ai/ui — Storage 场景组件导出
+ *
+ * 存储相关的场景化组件
+ * @module index
+ */
+export { default as AvatarUpload } from './AvatarUpload.svelte';
+export { default as FileList } from './FileList.svelte';
+// 文件上传
+export { default as FileUpload } from './FileUpload.svelte';
+// 图片上传
+export { default as ImageUpload } from './ImageUpload.svelte';

package/dist/components/scenes/types.d.ts

@@ -0,0 +1,583 @@
+/**
+ * @h-ai/ui — 场景组件类型定义
+ *
+ * 场景化组件的 Props 类型
+ * @module types
+ */
+import type { Snippet } from 'svelte';
+import type { Size } from '../../types.js';
+/**
+ * 密码输入框属性
+ */
+export interface PasswordInputProps {
+    /** 元素 ID */
+    id?: string;
+    /** 值 */
+    value?: string;
+    /** 占位符 */
+    placeholder?: string;
+    /** 尺寸 */
+    size?: Size;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 是否必填 */
+    required?: boolean;
+    /** 错误消息 */
+    error?: string;
+    /** 是否显示切换按钮 */
+    showToggle?: boolean;
+    /** 是否显示密码强度 */
+    showStrength?: boolean;
+    /** 最小长度 */
+    minLength?: number;
+    /** 自定义类名 */
+    class?: string;
+    /** 输入事件 */
+    oninput?: (e: Event & {
+        currentTarget: HTMLInputElement;
+    }) => void;
+    /** 变化事件 */
+    onchange?: (e: Event & {
+        currentTarget: HTMLInputElement;
+    }) => void;
+}
+/**
+ * 协议展示配置
+ */
+export interface AgreementDisplay {
+    /** 用户协议 URL */
+    userAgreementUrl?: string;
+    /** 隐私协议 URL */
+    privacyPolicyUrl?: string;
+}
+/**
+ * 登录表单数据
+ */
+export interface LoginFormData {
+    username: string;
+    password: string;
+    rememberMe: boolean;
+}
+/**
+ * 登录表单属性
+ */
+export interface LoginFormProps {
+    /** 加载状态 */
+    loading?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 是否显示记住我 */
+    showRememberMe?: boolean;
+    /** 是否显示忘记密码 */
+    showForgotPassword?: boolean;
+    /** 忘记密码链接 */
+    forgotPasswordUrl?: string;
+    /** 是否显示注册链接 */
+    showRegisterLink?: boolean;
+    /** 注册页面链接 */
+    registerUrl?: string;
+    /** 协议展示配置 */
+    agreements?: AgreementDisplay;
+    /** 提交按钮文本 */
+    submitText?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 错误信息 */
+    errors?: Record<string, string>;
+    /** 提交事件 */
+    onsubmit?: (data: LoginFormData) => void | Promise<void>;
+    /** 忘记密码事件 */
+    onforgotpassword?: () => void;
+    /** 头部插槽 */
+    header?: Snippet;
+    /** 底部插槽 */
+    footer?: Snippet;
+}
+/**
+ * 注册表单字段
+ */
+export type RegisterField = 'username' | 'email' | 'phone' | 'password' | 'confirmPassword' | 'nickname';
+/**
+ * 注册表单数据
+ */
+export interface RegisterFormData {
+    username?: string;
+    email?: string;
+    phone?: string;
+    password: string;
+    confirmPassword?: string;
+    nickname?: string;
+}
+/**
+ * 注册表单属性
+ */
+export interface RegisterFormProps {
+    /** 加载状态 */
+    loading?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 是否显示密码强度 */
+    showPasswordStrength?: boolean;
+    /** 是否需要确认密码 */
+    requireConfirmPassword?: boolean;
+    /** 最小密码长度 */
+    minPasswordLength?: number;
+    /** 显示的字段 */
+    fields?: RegisterField[];
+    /** 是否显示登录链接 */
+    showLoginLink?: boolean;
+    /** 登录页面链接 */
+    loginUrl?: string;
+    /** 协议展示配置 */
+    agreements?: AgreementDisplay;
+    /** 提交按钮文本 */
+    submitText?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 错误信息 */
+    errors?: Record<string, string>;
+    /** 提交事件 */
+    onsubmit?: (data: RegisterFormData) => void | Promise<void>;
+    /** 头部插槽 */
+    header?: Snippet;
+    /** 底部插槽 */
+    footer?: Snippet;
+}
+/**
+ * 修改密码表单数据
+ */
+export interface ChangePasswordFormData {
+    oldPassword?: string;
+    newPassword: string;
+    confirmPassword: string;
+}
+/**
+ * 修改密码表单属性
+ */
+export interface ChangePasswordFormProps {
+    /** 加载状态 */
+    loading?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否需要旧密码 */
+    requireOldPassword?: boolean;
+    /** 是否显示密码强度 */
+    showPasswordStrength?: boolean;
+    /** 最小密码长度 */
+    minPasswordLength?: number;
+    /** 提交按钮文本 */
+    submitText?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 错误信息 */
+    errors?: Record<string, string>;
+    /** 提交事件 */
+    onsubmit?: (data: ChangePasswordFormData) => void | Promise<void>;
+}
+/**
+ * 找回密码表单数据
+ */
+export interface ForgotPasswordFormData {
+    email?: string;
+    phone?: string;
+}
+/**
+ * 找回密码表单属性
+ */
+export interface ForgotPasswordFormProps {
+    /** 加载状态 */
+    loading?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 是否显示描述 */
+    showDescription?: boolean;
+    /** 找回方式 */
+    mode?: 'email' | 'phone';
+    /** 是否显示返回登录链接 */
+    showBackLink?: boolean;
+    /** 登录页面链接 */
+    loginUrl?: string;
+    /** 提交按钮文本 */
+    submitText?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 错误信息 */
+    errors?: Record<string, string>;
+    /** 提交事件 */
+    onsubmit?: (data: ForgotPasswordFormData) => void | Promise<void>;
+    /** 头部插槽 */
+    header?: Snippet;
+    /** 底部插槽 */
+    footer?: Snippet;
+}
+/**
+ * 重置密码表单数据
+ */
+export interface ResetPasswordFormData {
+    code?: string;
+    newPassword: string;
+    confirmPassword: string;
+}
+/**
+ * 重置密码表单属性
+ */
+export interface ResetPasswordFormProps {
+    /** 加载状态 */
+    loading?: boolean;
+    /** 禁用状态 */
+    disabled?: boolean;
+    /** 是否显示标题 */
+    showTitle?: boolean;
+    /** 是否显示描述 */
+    showDescription?: boolean;
+    /** 是否显示验证码 */
+    showCode?: boolean;
+    /** 是否显示密码强度 */
+    showPasswordStrength?: boolean;
+    /** 最小密码长度 */
+    minPasswordLength?: number;
+    /** 是否显示返回登录链接 */
+    showBackLink?: boolean;
+    /** 登录页面链接 */
+    loginUrl?: string;
+    /** 提交按钮文本 */
+    submitText?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 错误信息 */
+    errors?: Record<string, string>;
+    /** 提交事件 */
+    onsubmit?: (data: ResetPasswordFormData) => void | Promise<void>;
+}
+/**
+ * 用户个人信息字段
+ */
+export type UserProfileField = 'avatar' | 'username' | 'email' | 'displayName' | 'nickname' | 'phone' | 'bio';
+/**
+ * 用户信息
+ */
+export interface UserProfileData {
+    id?: string;
+    username?: string;
+    email?: string;
+    displayName?: string;
+    nickname?: string;
+    phone?: string;
+    avatar?: string;
+    avatarUrl?: string;
+    bio?: string;
+}
+export interface UserProfileSubmitData {
+    username: string;
+    email: string;
+    displayName: string;
+    phone: string;
+    bio: string;
+}
+/**
+ * 用户个人信息属性
+ */
+export interface UserProfileProps {
+    /** 用户信息 */
+    user?: UserProfileData;
+    /** 是否可编辑 */
+    editable?: boolean;
+    alwaysEditable?: boolean;
+    /** 加载状态 */
+    loading?: boolean;
+    /** 显示的字段 */
+    fields?: UserProfileField[];
+    /** 头像上传地址 */
+    avatarUploadUrl?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 错误信息 */
+    errors?: Record<string, string>;
+    /** 保存事件 */
+    onsubmit?: (data: UserProfileSubmitData) => void | Promise<void>;
+    /** 头像变更事件 */
+    onavatarchange?: (file: File) => void | Promise<void>;
+}
+/**
+ * 上传状态
+ */
+export type UploadState = 'pending' | 'uploading' | 'success' | 'error';
+/**
+ * 上传文件信息
+ */
+export interface UploadFile {
+    /** 唯一 ID */
+    id: string;
+    /** 原始文件 */
+    file: File;
+    /** 文件名 */
+    name: string;
+    /** 文件大小 */
+    size: number;
+    /** 文件类型 */
+    type: string;
+    /** 上传状态 */
+    state: UploadState;
+    /** 上传进度 (0-100) */
+    progress: number;
+    /** 错误信息 */
+    error?: string;
+    /** 上传响应 */
+    response?: unknown;
+}
+/**
+ * 文件上传属性
+ */
+export interface FileUploadProps {
+    /** 接受的文件类型 */
+    accept?: string;
+    /** 最大文件大小 (bytes) */
+    maxSize?: number;
+    /** 最大文件数量 */
+    maxFiles?: number;
+    /** 是否多选 */
+    multiple?: boolean;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 上传地址 */
+    uploadUrl?: string;
+    /** 签名 URL 地址 */
+    presignUrl?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 是否自动上传 */
+    autoUpload?: boolean;
+    /** 是否显示文件列表 */
+    showList?: boolean;
+    /** 是否支持拖拽 */
+    dragDrop?: boolean;
+    /** 自定义类名 */
+    class?: string;
+    /** 文件变化事件 */
+    onchange?: (files: UploadFile[]) => void;
+    /** 上传成功事件 */
+    onupload?: (file: UploadFile) => void;
+    /** 上传失败事件 */
+    onerror?: (error: string) => void;
+    /** 移除文件事件 */
+    onremove?: (file: UploadFile) => void;
+}
+/**
+ * 文件项
+ */
+export interface FileItem {
+    /** 唯一 ID */
+    id: string;
+    /** 文件名 */
+    name: string;
+    /** 文件大小 */
+    size: number;
+    /** 文件类型 */
+    type: string;
+    /** 文件 URL */
+    url?: string;
+    /** 缩略图 URL */
+    thumbnailUrl?: string;
+    /** 更新时间 */
+    updatedAt?: Date | string;
+}
+/**
+ * 文件列表属性
+ */
+export interface FileListProps {
+    /** 文件列表 */
+    files?: FileItem[];
+    /** 加载状态 */
+    loading?: boolean;
+    /** 是否显示预览 */
+    showPreview?: boolean;
+    /** 是否显示下载 */
+    showDownload?: boolean;
+    /** 是否显示删除 */
+    showDelete?: boolean;
+    /** 是否显示大小 */
+    showSize?: boolean;
+    /** 是否显示日期 */
+    showDate?: boolean;
+    /** 布局模式 */
+    layout?: 'list' | 'grid';
+    /** 自定义类名 */
+    class?: string;
+    /** 下载事件 */
+    ondownload?: (file: FileItem) => void;
+    /** 删除事件 */
+    ondelete?: (file: FileItem) => void;
+    /** 预览事件 */
+    onpreview?: (file: FileItem) => void;
+}
+/**
+ * 图片上传属性
+ */
+export interface ImageUploadProps {
+    /** 图片 URL */
+    value?: string;
+    /** 接受的文件类型 */
+    accept?: string;
+    /** 最大文件大小 (bytes) */
+    maxSize?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 上传地址 */
+    uploadUrl?: string;
+    /** 签名 URL 地址 */
+    presignUrl?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 占位文本 */
+    placeholder?: string;
+    /** 宽高比 */
+    aspectRatio?: string;
+    /** 宽度 */
+    width?: string;
+    /** 高度 */
+    height?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 变化事件 */
+    onchange?: (url: string) => void;
+    /** 错误事件 */
+    onerror?: (error: string) => void;
+}
+/**
+ * 头像上传属性
+ */
+export interface AvatarUploadProps {
+    /** 头像 URL */
+    value?: string;
+    /** 尺寸 */
+    size?: Size;
+    /** 接受的文件类型 */
+    accept?: string;
+    /** 最大文件大小 (bytes) */
+    maxSize?: number;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 上传地址 */
+    uploadUrl?: string;
+    /** 签名 URL 地址 */
+    presignUrl?: string;
+    /** 请求头 */
+    headers?: Record<string, string>;
+    /** 默认文字（没有图片时显示） */
+    fallback?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 变化事件 */
+    onchange?: (url: string) => void;
+    /** 错误事件 */
+    onerror?: (error: string) => void;
+}
+/**
+ * 加密输入框属性
+ */
+export interface EncryptedInputProps {
+    /** 原始值 */
+    value?: string;
+    /** 加密后的值 */
+    encryptedValue?: string;
+    /** 占位符 */
+    placeholder?: string;
+    /** 尺寸 */
+    size?: Size;
+    /** 是否禁用 */
+    disabled?: boolean;
+    /** 是否只读 */
+    readonly?: boolean;
+    /** 是否显示加密结果 */
+    showEncrypted?: boolean;
+    /** 加密算法 */
+    algorithm?: 'SM2' | 'SM4' | 'AES';
+    /** 加密函数 */
+    onencrypt?: (value: string) => Promise<string>;
+    /** 自定义类名 */
+    class?: string;
+    /** 输入事件 */
+    oninput?: (e: Event & {
+        currentTarget: HTMLInputElement;
+    }) => void;
+    /** 变化事件 */
+    onchange?: (e: Event & {
+        currentTarget: HTMLInputElement;
+    }) => void;
+}
+/**
+ * 哈希展示属性
+ */
+export interface HashDisplayProps {
+    /** 哈希值 */
+    value?: string;
+    /** 算法 */
+    algorithm?: 'SM3' | 'SHA256' | 'MD5';
+    /** 标签 */
+    label?: string;
+    /** 是否可复制 */
+    copyable?: boolean;
+    /** 是否截断显示 */
+    truncate?: boolean;
+    /** 截断长度 */
+    truncateLength?: number;
+    /** i18n 文案配置 */
+    labels?: {
+        copyHash?: string;
+    };
+    /** 自定义类名 */
+    class?: string;
+}
+/**
+ * Markdown 渲染器属性
+ */
+export interface MarkdownRendererProps {
+    /** Markdown 源文本 */
+    content?: string;
+    /** 自定义类名 */
+    class?: string;
+    /** 是否显示代码块复制按钮（默认 true） */
+    showCopyButton?: boolean;
+    /** 是否启用代码语法高亮（默认 true） */
+    enableHighlight?: boolean;
+    /** 是否将换行符转换为 <br>（默认 true，适合 AI 输出） */
+    breaks?: boolean;
+}
+/**
+ * 签名展示属性
+ */
+export interface SignatureDisplayProps {
+    /** 签名值 */
+    signature?: string;
+    /** 公钥 */
+    publicKey?: string;
+    /** 算法 */
+    algorithm?: 'SM2' | 'RSA' | 'ECDSA';
+    /** 验证状态 */
+    verified?: boolean;
+    /** 是否显示公钥 */
+    showPublicKey?: boolean;
+    /** 是否可复制 */
+    copyable?: boolean;
+    /** i18n 文案配置 */
+    labels?: {
+        signature?: string;
+        publicKey?: string;
+        verified?: string;
+        verifyFailed?: string;
+        notVerified?: string;
+        noSignature?: string;
+        copySignature?: string;
+        copyPublicKey?: string;
+    };
+    /** 自定义类名 */
+    class?: string;
+}

package/dist/components/scenes/types.js

@@ -0,0 +1,7 @@
+/**
+ * @h-ai/ui — 场景组件类型定义
+ *
+ * 场景化组件的 Props 类型
+ * @module types
+ */
+export {};

package/dist/i18n.svelte.d.ts

@@ -0,0 +1,44 @@
+/**
+ * @h-ai/ui — i18n Svelte 响应式封装
+ *
+ * 为 Svelte 5 应用提供 locale 状态管理的辅助工具
+ * @module i18n.svelte
+ */
+import type { Locale, LocaleInfo } from '@h-ai/core';
+declare const DEFAULT_LOCALE: string, DEFAULT_LOCALES: LocaleInfo[], setGlobalLocale: (locale: Locale) => void;
+declare function isLocaleSupported(locale: Locale, supportedLocales?: LocaleInfo[]): boolean;
+declare function resolveLocale(locale: Locale, supportedLocales?: LocaleInfo[], defaultLocale?: Locale): Locale;
+declare function detectBrowserLocale(supportedLocales?: LocaleInfo[]): Locale | null;
+declare function interpolate(template: string, params?: Record<string, string | number | boolean>): string;
+/**
+ * 创建 locale 状态管理器
+ *
+ * @param options - 配置选项
+ * @param options.defaultLocale - 默认 locale
+ * @param options.supportedLocales - 支持的 locale 列表
+ * @param options.detectBrowser - 是否检测浏览器语言
+ * @param options.persistKey - localStorage key
+ * @returns locale 状态对象
+ */
+export declare function createLocaleStore(options?: {
+    defaultLocale?: Locale;
+    supportedLocales?: LocaleInfo[];
+    detectBrowser?: boolean;
+    persistKey?: string;
+}): {
+    /** 当前语言（响应式） */
+    readonly current: string;
+    /** 支持的语言列表 */
+    readonly supported: LocaleInfo[];
+    /**
+     * 设置当前语言
+     * 会同步到 @h-ai/core 的全局 locale 管理器
+     * 注意：你还需要调用 Paraglide 的 setLocale 来更新 UI 翻译
+     */
+    set(locale: Locale): void;
+    /** 检查语言是否支持 */
+    isSupported(locale: Locale): boolean;
+};
+export type { InterpolationParams, Locale, LocaleInfo } from '@h-ai/core';
+export { DEFAULT_LOCALE, DEFAULT_LOCALES, detectBrowserLocale, interpolate, isLocaleSupported, resolveLocale, setGlobalLocale, };
+export declare const getGlobalLocale: () => Locale;