@h-ai/ui 0.1.0-alpha.10

package/dist/types.js

@@ -0,0 +1,7 @@
+/**
+ * @h-ai/ui — 类型定义
+ *
+ * UI 组件相关类型
+ * @module types
+ */
+export {};

package/dist/utils/platform.svelte.d.ts

@@ -0,0 +1,54 @@
+/**
+ * @h-ai/ui — 平台检测工具
+ *
+ * 提供运行时平台检测与 Svelte 5 响应式平台状态。
+ * @module platform
+ */
+/** 运行平台 */
+export type Platform = 'web' | 'h5' | 'android' | 'ios' | 'unknown';
+/**
+ * 检测当前运行平台
+ *
+ * @returns 当前平台标识
+ *
+ * @example
+ * ```ts
+ * const platform = detectPlatform()
+ * if (platform === 'android') {
+ *   // Android 特定逻辑
+ * }
+ * ```
+ */
+export declare function detectPlatform(): Platform;
+/**
+ * 判断是否为移动端
+ */
+export declare function isMobile(): boolean;
+/**
+ * 判断是否为 Capacitor App
+ */
+export declare function isNativeApp(): boolean;
+/**
+ * Svelte 5 Runes 响应式平台状态
+ *
+ * @returns 包含当前平台、是否移动端和是否原生应用的响应式对象
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { usePlatform } from '@hai/ui'
+ *   const platform = usePlatform()
+ * </script>
+ *
+ * {#if platform.isMobile}
+ *   <BottomNav />
+ * {:else}
+ *   <Sidebar />
+ * {/if}
+ * ```
+ */
+export declare function usePlatform(): {
+    readonly current: Platform;
+    readonly isMobile: boolean;
+    readonly isApp: boolean;
+};

package/dist/utils/platform.svelte.js

@@ -0,0 +1,89 @@
+/**
+ * @h-ai/ui — 平台检测工具
+ *
+ * 提供运行时平台检测与 Svelte 5 响应式平台状态。
+ * @module platform
+ */
+const ANDROID_UA_REGEX = /android/;
+const IOS_UA_REGEX = /iphone|ipad|ipod/;
+/**
+ * 检测当前运行平台
+ *
+ * @returns 当前平台标识
+ *
+ * @example
+ * ```ts
+ * const platform = detectPlatform()
+ * if (platform === 'android') {
+ *   // Android 特定逻辑
+ * }
+ * ```
+ */
+export function detectPlatform() {
+    if (typeof window === 'undefined') {
+        return 'unknown';
+    }
+    const ua = navigator.userAgent.toLowerCase();
+    // Capacitor 注入全局标识
+    if ('Capacitor' in window) {
+        const cap = window.Capacitor;
+        const platform = cap?.getPlatform?.();
+        if (platform === 'android')
+            return 'android';
+        if (platform === 'ios')
+            return 'ios';
+    }
+    // 移动端 UA 检测
+    if (ANDROID_UA_REGEX.test(ua))
+        return 'h5';
+    if (IOS_UA_REGEX.test(ua))
+        return 'h5';
+    // 移动端特征检测
+    if ('ontouchstart' in window && navigator.maxTouchPoints > 0 && window.innerWidth < 768) {
+        return 'h5';
+    }
+    return 'web';
+}
+/**
+ * 判断是否为移动端
+ */
+export function isMobile() {
+    const platform = detectPlatform();
+    return platform === 'h5' || platform === 'android' || platform === 'ios';
+}
+/**
+ * 判断是否为 Capacitor App
+ */
+export function isNativeApp() {
+    const platform = detectPlatform();
+    return platform === 'android' || platform === 'ios';
+}
+/**
+ * Svelte 5 Runes 响应式平台状态
+ *
+ * @returns 包含当前平台、是否移动端和是否原生应用的响应式对象
+ *
+ * @example
+ * ```svelte
+ * <script>
+ *   import { usePlatform } from '@hai/ui'
+ *   const platform = usePlatform()
+ * </script>
+ *
+ * {#if platform.isMobile}
+ *   <BottomNav />
+ * {:else}
+ *   <Sidebar />
+ * {/if}
+ * ```
+ */
+export function usePlatform() {
+    const current = $state(detectPlatform());
+    const mobile = $derived(current === 'h5' || current === 'android' || current === 'ios');
+    const app = $derived(current === 'android' || current === 'ios');
+    return {
+        get current() { return current; },
+        get isMobile() { return mobile; },
+        get isApp() { return app; },
+    };
+}

package/dist/utils.d.ts

@@ -0,0 +1,46 @@
+/**
+ * @h-ai/ui — 样式工具
+ *
+ * CSS 类名处理工具
+ * @module utils
+ */
+import type { Size, Variant } from './types.js';
+/**
+ * 合并类名（支持 Tailwind 类冲突消解）
+ *
+ * @param classes - 类名列表
+ * @returns 合并后的类名字符串
+ */
+export declare function cn(...classes: (string | boolean | undefined | null)[]): string;
+/**
+ * 获取变体类名
+ */
+export declare function getVariantClass(variant: Variant, prefix?: string): string;
+/**
+ * 获取尺寸类名
+ */
+export declare function getSizeClass(size: Size, prefix?: string): string;
+/**
+ * 输入框尺寸类名
+ */
+export declare function getInputSizeClass(size: Size): string;
+/**
+ * 徽章变体类名
+ */
+export declare function getBadgeVariantClass(variant: Variant): string;
+/**
+ * 徽章尺寸类名
+ */
+export declare function getBadgeSizeClass(size: Size): string;
+/**
+ * 警告框变体类名
+ */
+export declare function getAlertVariantClass(variant: Variant): string;
+/**
+ * 进度条变体类名
+ */
+export declare function getProgressVariantClass(variant: Variant): string;
+/**
+ * 生成唯一 ID
+ */
+export declare function generateId(prefix?: string): string;

package/dist/utils.js

@@ -0,0 +1,163 @@
+/**
+ * @h-ai/ui — 样式工具
+ *
+ * CSS 类名处理工具
+ * @module utils
+ */
+import { twMerge } from 'tailwind-merge';
+/**
+ * 合并类名（支持 Tailwind 类冲突消解）
+ *
+ * @param classes - 类名列表
+ * @returns 合并后的类名字符串
+ */
+export function cn(...classes) {
+    return twMerge(classes.filter(Boolean).join(' '));
+}
+/**
+ * 已知前缀的变体类名静态映射
+ *
+ * 使用静态字符串而非模板字符串拼接，确保 TailwindCSS 可静态扫描到所有类名。
+ */
+const VARIANT_MAPS = {
+    btn: {
+        default: 'btn-neutral',
+        primary: 'btn-primary',
+        secondary: 'btn-secondary',
+        success: 'btn-success',
+        warning: 'btn-warning',
+        error: 'btn-error',
+        info: 'btn-info',
+        ghost: 'btn-ghost',
+        link: 'btn-link',
+        outline: 'btn-outline',
+    },
+    badge: {
+        default: 'badge-neutral',
+        primary: 'badge-primary',
+        secondary: 'badge-secondary',
+        success: 'badge-success',
+        warning: 'badge-warning',
+        error: 'badge-error',
+        info: 'badge-info',
+        ghost: 'badge-ghost',
+        link: 'badge-link',
+        outline: 'badge-outline',
+    },
+    progress: {
+        default: 'progress-neutral',
+        primary: 'progress-primary',
+        secondary: 'progress-secondary',
+        success: 'progress-success',
+        warning: 'progress-warning',
+        error: 'progress-error',
+        info: 'progress-info',
+        ghost: 'progress-ghost',
+        link: 'progress-link',
+        outline: 'progress-outline',
+    },
+};
+/**
+ * 已知前缀的尺寸类名静态映射
+ */
+const SIZE_MAPS = {
+    btn: {
+        'xs': 'btn-xs',
+        'sm': 'btn-sm',
+        'md': '',
+        'lg': 'btn-lg',
+        'xl': 'btn-xl',
+        '2xl': 'btn-xl',
+        '3xl': 'btn-xl',
+        '4xl': 'btn-xl',
+    },
+    badge: {
+        'xs': 'badge-xs',
+        'sm': 'badge-sm',
+        'md': '',
+        'lg': 'badge-lg',
+        'xl': 'badge-xl',
+        '2xl': 'badge-xl',
+        '3xl': 'badge-xl',
+        '4xl': 'badge-xl',
+    },
+};
+/**
+ * 获取变体类名
+ */
+export function getVariantClass(variant, prefix = 'btn') {
+    const map = VARIANT_MAPS[prefix];
+    if (map)
+        return map[variant] ?? map.default;
+    // 未预置的前缀回退为动态拼接（调用方需自行确保 Tailwind 可扫描）
+    return `${prefix}-${variant === 'default' ? 'neutral' : variant}`;
+}
+/**
+ * 获取尺寸类名
+ */
+export function getSizeClass(size, prefix = 'btn') {
+    if (size === 'md')
+        return '';
+    const map = SIZE_MAPS[prefix];
+    if (map)
+        return map[size] ?? '';
+    return `${prefix}-${size}`;
+}
+/**
+ * 输入框尺寸类名
+ */
+export function getInputSizeClass(size) {
+    const map = {
+        'xs': 'input-xs',
+        'sm': 'input-sm',
+        'md': '',
+        'lg': 'input-lg',
+        'xl': 'input-xl',
+        '2xl': 'input-xl',
+        '3xl': 'input-xl',
+        '4xl': 'input-xl',
+    };
+    return map[size] ?? '';
+}
+/**
+ * 徽章变体类名
+ */
+export function getBadgeVariantClass(variant) {
+    return getVariantClass(variant, 'badge');
+}
+/**
+ * 徽章尺寸类名
+ */
+export function getBadgeSizeClass(size) {
+    return getSizeClass(size, 'badge');
+}
+/**
+ * 警告框变体类名
+ */
+export function getAlertVariantClass(variant) {
+    const map = {
+        default: 'alert',
+        primary: 'alert-primary',
+        secondary: 'alert-secondary',
+        success: 'alert-success',
+        warning: 'alert-warning',
+        error: 'alert-error',
+        info: 'alert-info',
+        ghost: 'alert',
+        link: 'alert',
+        outline: 'alert',
+    };
+    return map[variant] ?? map.default;
+}
+/**
+ * 进度条变体类名
+ */
+export function getProgressVariantClass(variant) {
+    return getVariantClass(variant, 'progress');
+}
+/**
+ * 生成唯一 ID
+ */
+export function generateId(prefix = 'hai') {
+    return `${prefix}-${Math.random().toString(36).slice(2, 9)}`;
+}

package/package.json

@@ -0,0 +1,70 @@
+{
+  "name": "@h-ai/ui",
+  "type": "module",
+  "version": "0.1.0-alpha.10",
+  "description": "Hai Framework UI component library for Svelte 5 Runes.",
+  "license": "Apache-2.0",
+  "svelte": "./dist/index.js",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "svelte": "./dist/index.js",
+      "import": "./dist/index.js"
+    },
+    "./auto-import": {
+      "types": "./auto-import.d.ts",
+      "import": "./auto-import.js"
+    },
+    "./components/*": {
+      "types": "./dist/components/*.d.ts",
+      "svelte": "./dist/components/*.js",
+      "import": "./dist/components/*.js"
+    },
+    "./styles/*": "./dist/styles/*"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "auto-import.d.ts",
+    "auto-import.js",
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "peerDependencies": {
+    "svelte": "^5.53.5"
+  },
+  "dependencies": {
+    "@internationalized/date": "^3.8.0",
+    "@shikijs/langs": "^4.0.2",
+    "bits-ui": "^2.8.0",
+    "marked": "^18.0.0",
+    "shiki": "^4.0.2",
+    "tailwind-merge": "^3.5.0",
+    "@h-ai/core": "0.1.0-alpha.10"
+  },
+  "devDependencies": {
+    "@sveltejs/package": "^2.5.7",
+    "@sveltejs/vite-plugin-svelte": "^7.0.0",
+    "@types/node": "^25.1.0",
+    "jsdom": "^29.0.2",
+    "rimraf": "^6.0.1",
+    "svelte": "^5.53.5",
+    "svelte-check": "^4.4.6",
+    "typescript": "^6.0.2",
+    "vite": "^8.0.0",
+    "vitest": "^4.0.18"
+  },
+  "scripts": {
+    "build": "svelte-package -i src/lib",
+    "dev": "svelte-package -i src/lib --watch",
+    "check": "svelte-check --tsconfig ./tsconfig.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "clean": "rimraf dist .turbo"
+  }
+}