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

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.61",
+  "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.61",
+    "@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',