@h-ai/ui 0.1.0-alpha.60 → 0.1.0-alpha.62

package/dist/messages/zh-CN.json

@@ -351,5 +351,22 @@
   "password_policy_uppercase": "包含大写字母",
   "password_policy_lowercase": "包含小写字母",
   "password_policy_number": "包含数字",
-  "password_policy_special": "包含特殊字符"
+  "password_policy_special": "包含特殊字符",
+  "guide_welcome": "欢迎使用",
+  "guide_start": "开始引导",
+  "guide_later": "稍后提醒",
+  "guide_dismiss": "不再提醒",
+  "guide_help": "帮助中心",
+  "guide_close": "关闭",
+  "guide_loading": "正在准备引导…",
+  "guide_next": "下一步",
+  "guide_previous": "上一步",
+  "guide_done": "完成",
+  "guide_progress": "第 {current} / {total} 步",
+  "guide_search": "搜索帮助内容",
+  "guide_empty": "没有找到相关帮助内容",
+  "guide_tours": "操作导览",
+  "guide_unavailable": "此引导暂不可用，请从帮助中心选择其他内容。",
+  "guide_targetMissing": "当前页面暂未提供此操作。请稍后重试或查看帮助内容。",
+  "guide_startFailed": "无法开始引导，请稍后重试。"
 }

package/dist/messages.d.ts

@@ -11,6 +11,7 @@ export type UIMessageKey = keyof typeof messagesZhCN;
  *
  * @param key - 消息 key
  * @param params - 可选的插值参数
+ * @param locale - 可选的宿主语言；省略时使用现有全局语言
  * @returns 当前 locale 对应的翻译文本
  *
  * @example
@@ -18,7 +19,7 @@ export type UIMessageKey = keyof typeof messagesZhCN;
  * uiM('password_show') // => '显示密码' (zh-CN) 或 'Show password' (en-US)
  * ```
  */
-export declare function uiM(key: UIMessageKey, params?: Record<string, string | number | boolean>): string;
+export declare function uiM(key: UIMessageKey, params?: Record<string, string | number | boolean>, locale?: string): string;
 /**
  * 获取当前 UI 模块使用的 locale
  */

package/dist/messages.js

@@ -18,6 +18,7 @@ const getMessage = core.i18n.createMessageGetter({
  *
  * @param key - 消息 key
  * @param params - 可选的插值参数
+ * @param locale - 可选的宿主语言；省略时使用现有全局语言
  * @returns 当前 locale 对应的翻译文本
  *
  * @example
@@ -25,8 +26,8 @@ const getMessage = core.i18n.createMessageGetter({
  * uiM('password_show') // => '显示密码' (zh-CN) 或 'Show password' (en-US)
  * ```
  */
-export function uiM(key, params) {
-    return getMessage(key, params ? { params } : undefined);
+export function uiM(key, params, locale) {
+    return getMessage(key, { params, locale });
 }
 /**
  * 获取当前 UI 模块使用的 locale

package/dist/styles/guide.css

@@ -0,0 +1,88 @@
+/* 引导浮层挂到 body，使用全局主题变量，避免 Svelte 局部样式失效。 */
+.driver-popover.hai-guide-popover {
+  background: var(--color-base-100);
+  color: var(--color-base-content);
+  border: 1px solid color-mix(in oklch, var(--color-base-content) 12%, transparent);
+  border-radius: var(--hai-radius-lg, 16px);
+  box-shadow: var(--shadow-overlay, 0 16px 48px -12px #0003);
+  padding: 20px;
+  min-width: 240px;
+  max-width: min(360px, calc(100vw - 24px));
+  --driver-popover-font-family: inherit;
+}
+
+.hai-guide-popover .driver-popover-title {
+  font-size: 16px;
+  font-weight: 600;
+  line-height: 1.5;
+}
+.hai-guide-popover .driver-popover-description {
+  font-size: 14px;
+  line-height: 1.75;
+  overflow-wrap: anywhere;
+}
+.hai-guide-popover .driver-popover-progress-text {
+  color: color-mix(in oklch, var(--color-base-content) 55%, transparent);
+  font-size: 12px;
+}
+.hai-guide-popover .driver-popover-close-btn {
+  color: var(--color-base-content);
+  min-width: 36px;
+  min-height: 36px;
+}
+.hai-guide-popover .driver-popover-footer button {
+  border: 1px solid color-mix(in oklch, var(--color-base-content) 12%, transparent);
+  border-radius: var(--hai-radius-md, 8px);
+  background: var(--color-base-200);
+  color: var(--color-base-content);
+  padding: 8px 12px;
+  font-size: 13px;
+  font-weight: 500;
+  text-shadow: none;
+  min-height: 36px;
+}
+.hai-guide-popover .driver-popover-footer .driver-popover-next-btn {
+  background: var(--color-primary);
+  color: var(--color-primary-content);
+  border-color: var(--color-primary);
+}
+.hai-guide-popover button:focus-visible {
+  outline: 2px solid var(--color-primary);
+  outline-offset: 2px;
+}
+.hai-guide-popover .driver-popover-arrow-side-top {
+  border-top-color: var(--color-base-100);
+}
+.hai-guide-popover .driver-popover-arrow-side-bottom {
+  border-bottom-color: var(--color-base-100);
+}
+.hai-guide-popover .driver-popover-arrow-side-left {
+  border-left-color: var(--color-base-100);
+}
+.hai-guide-popover .driver-popover-arrow-side-right {
+  border-right-color: var(--color-base-100);
+}
+.hai-guide-offer {
+  padding-bottom: max(20px, env(safe-area-inset-bottom));
+}
+
+/* 引擎会禁用高亮区域外的指针事件，等待提示的取消按钮必须保持可操作。 */
+.driver-active .hai-guide-loading,
+.driver-active .hai-guide-loading * {
+  pointer-events: auto;
+}
+
+@media (max-width: 640px) {
+  .hai-guide-popover .driver-popover-footer button,
+  .hai-guide-popover .driver-popover-close-btn {
+    min-height: var(--hai-touch-target-min, 44px);
+  }
+}
+
+@media (prefers-reduced-motion: reduce) {
+  .driver-overlay,
+  .hai-guide-popover {
+    animation: none !important;
+    transition: none !important;
+  }
+}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@h-ai/ui",
   "type": "module",
-  "version": "0.1.0-alpha.60",
+  "version": "0.1.0-alpha.62",
   "description": "Hai Framework UI component library for Svelte 5 Runes.",
   "license": "Apache-2.0",
   "svelte": "./dist/index.js",
@@ -23,6 +23,11 @@
       "types": "./dist/theme-config.d.ts",
       "import": "./dist/theme-config.js"
     },
+    "./guide": {
+      "types": "./dist/guide.d.ts",
+      "svelte": "./dist/guide.js",
+      "import": "./dist/guide.js"
+    },
     "./components/*": {
       "types": "./dist/components/*.d.ts",
       "svelte": "./dist/components/*.js",
@@ -49,10 +54,11 @@
     "svelte": "^5.57.2"
   },
   "dependencies": {
-    "@h-ai/core": "0.1.0-alpha.60",
+    "@h-ai/core": "0.1.0-alpha.62",
     "@internationalized/date": "^3.12.4",
     "@shikijs/langs": "^4.5.0",
     "bits-ui": "^2.19.5",
+    "driver.js": "1.9.0",
     "html2canvas": "^1.4.1",
     "jspdf": "^4.2.1",
     "layerchart": "2.6.1",

package/vite.js

@@ -68,6 +68,7 @@ export const haiPrebundledDeps = Object.freeze([
   'html2canvas',
   // ─── 工具 ───
   'tailwind-merge',
+  'driver.js',
   // ─── 框架运行时（@h-ai/core / @h-ai/crypto / @h-ai/kit 在登录等路径引入） ───
   'nanoid',
   'process',