@opentiny/tiny-robot 0.1.0-alpha.0 → 0.1.0

package/src/question/index.less

@@ -0,0 +1,448 @@
+@import './vars.less';
+
+/**
+ * TR Question 组件样式
+ */
+
+/* ================ 滚动穿透防止 ================ */
+/**
+ * 当弹窗打开时应用于body的类
+ * 解决滚动穿透问题 - 防止弹窗打开时背景内容滚动
+ */
+body.tr-modal-open {
+  overflow: hidden !important;
+  position: fixed;
+  width: 100%;
+  height: 100%;
+}
+
+/* ================ 基础容器样式 ================ */
+/**
+ * 组件根容器
+ */
+.tr-question-container {
+  position: relative;
+  display: flex;
+  align-items: center;
+  height: var(--tr-question-container-height);
+  padding: 0;
+  font-size: var(--tr-question-font-size);
+  line-height: var(--tr-question-line-height);
+  color: var(--tr-question-text-color);
+  box-sizing: border-box;
+}
+
+/* ================ 触发按钮样式 ================ */
+/**
+ * 热门问题触发按钮
+ * 位于左侧，点击显示弹窗
+ */
+.tr-question-trigger {
+  position: absolute;
+  top: 5px;
+  left: 0;
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  margin: 2px 8px 0 0;
+  cursor: pointer;
+
+  &:hover {
+    transform: scale(1.05);
+  }
+
+  /* 按钮图标 */
+  & > svg {
+    width: 28px;
+    height: 28px;
+    border-radius: 50%;
+    fill: #ffffff;
+  }
+
+  & > svg:hover {
+    fill: #f5f5f5;
+    transform: scale(1.05);
+  }
+}
+
+/* ================ 弹窗样式 ================ */
+/**
+ * 弹窗外层遮罩
+ * 全屏遮罩层，内部包含问题弹窗
+ */
+.tr-question-modal-backdrop {
+  position: fixed;
+  top: 0;
+  left: 0;
+  right: 0;
+  bottom: 0;
+  background-color: var(--tr-question-modal-backdrop-color);
+  display: flex;
+  justify-content: center;
+  align-items: center;
+  z-index: 1000;
+  overflow: hidden;
+  overscroll-behavior: contain; /* 防止滚动传递 */
+}
+
+/**
+ * 问题弹窗面板
+ * 包含标题、分类标签和问题列表
+ */
+.tr-question-panel {
+  position: relative;
+  border: none;
+  border-radius: var(--tr-question-border-radius);
+  padding: var(--tr-question-modal-padding);
+  box-shadow: var(--tr-question-panel-shadow);
+  background-color: var(--tr-question-modal-background-color);
+  max-height: var(--tr-question-modal-max-height);
+  max-width: var(--tr-question-modal-max-width);
+  width: 100%;
+  display: flex;
+  flex-direction: column;
+  overflow: hidden;
+  box-sizing: border-box;
+}
+
+/**
+ * 弹窗标题栏
+ * 包含标题文本和关闭按钮
+ */
+.tr-question-header {
+  display: flex;
+  justify-content: space-between;
+  align-items: center;
+  margin-bottom: var(--tr-question-spacing);
+
+  /* 标题文本 */
+  &-title {
+    font-size: var(--tr-question-title-font-size);
+    font-weight: var(--tr-question-title-font-weight);
+    color: var(--tr-question-title-color);
+  }
+
+  /* 关闭按钮 */
+  .tr-question-close-btn {
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    justify-content: center;
+    color: var(--tr-question-close-icon-color);
+    transition: var(--tr-question-hover-transition);
+
+    &:hover {
+      color: var(--tr-question-text-color);
+    }
+  }
+}
+
+/* ================ 分类标签样式 ================ */
+/**
+ * 分类标签容器
+ * 水平展示问题分类，支持点击切换
+ */
+.tr-question-categories {
+  display: flex;
+  flex-wrap: wrap;
+  gap: 8px;
+
+  /**
+   * 单个分类标签
+   * 支持悬停和激活状态样式
+   */
+  &-item {
+    box-sizing: border-box;
+    border-radius: var(--tr-question-category-border-radius);
+    background: var(--tr-question-category-bg);
+    border: 1px solid transparent;
+    height: var(--tr-question-category-height);
+    padding: 10px 16px;
+    margin-right: 8px;
+    color: var(--tr-question-tab-text);
+    transition: var(--tr-question-hover-transition);
+    display: flex;
+    align-items: center;
+    gap: 4px;
+
+    /* 分类图标 */
+    .category-icon {
+      font-size: var(--tr-question-icon-size);
+      margin-right: 4px;
+    }
+
+    /* 悬停效果 */
+    &:hover {
+      cursor: pointer;
+      background: var(--tr-question-category-hover-bg);
+    }
+
+    /* 激活状态 */
+    &.active {
+      background: var(--tr-question-common-bg) !important;
+      border: 1px solid var(--tr-question-category-active-border) !important;
+      color: var(--tr-question-text-color);
+      font-weight: 500;
+    }
+  }
+}
+
+/* ================ 问题列表样式 ================ */
+/**
+ * 问题内容区
+ * 包含问题列表，支持滚动
+ */
+.tr-question-content {
+  flex: 1;
+  max-height: var(--tr-question-content-max-height);
+  overflow-y: auto;
+  padding: 10px 0;
+  overscroll-behavior: contain;
+  position: relative;
+
+  /**
+   * 自定义滚动条样式
+   */
+  &::-webkit-scrollbar {
+    width: var(--tr-question-scrollbar-width);
+    height: 10px;
+  }
+
+  &::-webkit-scrollbar-track {
+    background: var(--tr-question-scrollbar-track-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background-color: var(--tr-question-scrollbar-thumb-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+    transition: background-color var(--tr-question-transition-duration);
+  }
+
+  &::-webkit-scrollbar-thumb:hover {
+    background-color: var(--tr-question-scrollbar-thumb-hover-bg);
+  }
+
+  /**
+   * 问题列表
+   */
+  & > ul {
+    list-style: none;
+    padding: 0;
+    margin: 0;
+
+    /**
+     * 问题项
+     * 支持悬停效果和溢出文本处理
+     */
+    & > li {
+      color: var(--tr-question-common-text);
+      font-size: var(--tr-question-font-size);
+      font-weight: var(--tr-question-item-font-weight);
+      line-height: var(--tr-question-item-height);
+      text-align: left;
+      height: var(--tr-question-item-height);
+      border-radius: var(--tr-question-list-border-radius);
+      background: var(--tr-question-list-item-bg);
+      cursor: pointer;
+      margin: 5px 1px 2px 1px;
+      padding: 0 var(--tr-question-spacing);
+      white-space: nowrap;
+      overflow: hidden;
+      text-overflow: ellipsis;
+      border-bottom: 1px solid var(--tr-question-item-border-color);
+      transition: var(--tr-question-hover-transition);
+
+      /* 序号样式 */
+      span:first-child {
+        display: inline-block;
+        margin-right: 4px;
+        color: var(--tr-question-text-color-secondary);
+      }
+
+      /* 最后一项去除底部边框 */
+      &:last-child {
+        border-bottom: none;
+      }
+
+      /* 悬停效果 */
+      &:hover {
+        box-shadow: 0 2px 12px var(--tr-question-list-hover-shadow);
+        position: relative;
+        z-index: 10;
+        transform: translateY(-2px);
+      }
+    }
+  }
+
+  /**
+   * 换行模式下的问题项样式
+   */
+  &-wrap .tr-question-list-item {
+    white-space: normal;
+    height: auto;
+    min-height: var(--tr-question-item-height);
+    line-height: var(--tr-question-item-line-height);
+    padding-top: 8px;
+    padding-bottom: 8px;
+  }
+}
+
+/* ================ 常见问题样式 ================ */
+/**
+ * 常见问题容器
+ * 横向展示常见问题
+ */
+.tr-common-questions {
+  margin-left: 40px;
+  width: calc(100% - 40px);
+  display: flex;
+  align-items: center;
+  flex: 1;
+  height: 100%;
+  overflow-x: auto;
+  overflow-y: hidden;
+  white-space: nowrap;
+  flex-wrap: nowrap;
+  transition: all 0.3s ease;
+  position: relative;
+
+  &.expanded {
+    flex-wrap: wrap;
+    align-content: flex-end;
+    height: auto;
+    max-height: 200px; /* 可以根据需要调整 */
+    overflow-y: auto;
+    position: absolute;
+    bottom: 0;
+    z-index: 5;
+    padding: 8px 0;
+  }
+
+  /**
+   * 常见问题项
+   * 支持悬停效果和溢出文本处理
+   */
+  &_item {
+    max-width: 515px;
+    text-overflow: ellipsis;
+    overflow: hidden;
+    display: flex;
+    align-items: center;
+    gap: 8px;
+    white-space: nowrap;
+    color: var(--tr-question-common-text);
+    border: none;
+    background: var(--tr-question-common-bg);
+    margin: 1px 8px 4px 0;
+    cursor: pointer;
+    text-decoration: none;
+    height: var(--tr-question-common-item-height);
+    padding: 0 16px;
+    border-radius: var(--tr-question-common-border-radius);
+    box-shadow: var(--tr-question-common-item-shadow);
+    transition: var(--tr-question-hover-transition);
+
+    & > svg {
+      width: 16px;
+      height: 16px;
+    }
+
+    /* 悬停效果 */
+    &:hover {
+      background-color: var(--tr-question-common-hover-bg);
+      transform: translateY(-1px);
+    }
+  }
+
+  /* 自定义滚动条 */
+  &::-webkit-scrollbar {
+    height: var(--tr-question-scrollbar-width);
+  }
+
+  &::-webkit-scrollbar-track {
+    background: var(--tr-question-scrollbar-track-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+  }
+
+  &::-webkit-scrollbar-thumb {
+    background-color: var(--tr-question-scrollbar-thumb-bg);
+    border-radius: var(--tr-question-scrollbar-border-radius);
+  }
+
+  &::-webkit-scrollbar-thumb:hover {
+    background-color: var(--tr-question-scrollbar-thumb-hover-bg);
+  }
+}
+
+/* ================ 切换按钮样式 ================ */
+
+/**
+ * 换行切换按钮
+ * 控制问题展示方式
+ */
+.tr-question-wrap-trigger {
+  position: absolute;
+  right: 0;
+  z-index: 10;
+  cursor: pointer;
+  display: flex;
+  align-items: center;
+  justify-content: center;
+  width: 26px;
+  height: 26px;
+
+  /* 按钮图标 */
+  & > svg {
+    width: 1em;
+    height: 1em;
+    font-size: 32px;
+    border-radius: 50%;
+    fill: #ffffff;
+  }
+
+  & > svg:hover {
+    fill: #f5f5f5;
+  }
+}
+
+/* ================ 状态指示器样式 ================ */
+/**
+ * 加载状态
+ */
+.tr-question-loading {
+  padding: var(--tr-question-spacing);
+  text-align: center;
+
+  &-spinner {
+    width: 24px;
+    height: 24px;
+    border: 2px solid var(--tr-question-border-color);
+    border-top-color: var(--tr-question-primary-color);
+    border-radius: 50%;
+    margin: 0 auto;
+    animation: tr-question-spin 1s linear infinite;
+  }
+}
+
+/**
+ * 空状态
+ */
+.tr-question-empty {
+  padding: var(--tr-question-spacing);
+  text-align: center;
+  color: var(--tr-question-text-color-secondary);
+}
+
+/* ================ 动画效果 ================ */
+/**
+ * 加载动画
+ */
+@keyframes tr-question-spin {
+  0% {
+    transform: rotate(0deg);
+  }
+  100% {
+    transform: rotate(360deg);
+  }
+}

package/src/question/index.ts

@@ -0,0 +1,12 @@
+import { App } from 'vue'
+import Question from './index.vue'
+
+Question.name = 'TrQuestion'
+
+const install = function <T>(app: App<T>) {
+  app.component(Question.name!, Question)
+}
+
+Question.install = install
+
+export default Question as typeof Question & { install: typeof install }

package/src/question/index.type.ts

@@ -0,0 +1,86 @@
+export interface Category {
+  id: string
+  label: string
+  icon?: string
+  questions: Question[]
+}
+
+export interface Question {
+  id: string
+  text: string
+  keywords?: string[]
+}
+
+export interface TrQuestionPanel {
+  openModal: () => void
+  closeModal: () => void
+  toggleFloating: () => void
+  setActiveCategory: (categoryId: string) => void
+  refreshData: () => Promise<void>
+}
+
+export type ThemeType = 'light' | 'dark'
+
+/**
+ * Question组件属性定义
+ */
+export interface QuestionProps {
+  /**
+   * 问题分类列表
+   * 包含多个分类，每个分类下有多个问题
+   */
+  categories: Category[]
+
+  /**
+   * 浮动显示的问题列表
+   * 显示在组件底部的常见问题胶囊
+   */
+  commonQuestions: Question[]
+
+  /**
+   * 是否初始展开常见问题
+   * @default false
+   */
+  initialExpanded?: boolean
+
+  /**
+   * 弹窗宽度
+   * @default '640px'
+   */
+  modalWidth?: string
+
+  /**
+   * 主题类型
+   * @default 'light'
+   */
+  theme?: ThemeType
+
+  /**
+   * 是否点击外部关闭弹窗
+   * @default true
+   */
+  closeOnClickOutside?: boolean
+
+  /**
+   * 是否显示加载中状态
+   * @default false
+   */
+  loading?: boolean
+}
+
+/**
+ * Question组件事件定义
+ */
+export type QuestionEmits = {
+  /**
+   * 问题点击事件
+   * @param question 被点击的问题对象
+   */
+  'question-click': [question: Question]
+
+  /**
+   * 分类选择事件
+   * @param category 被选择的分类对象
+   */
+  'select-category': [category: Category]
+}

package/src/question/index.vue

@@ -0,0 +1,140 @@
+<script setup lang="ts">
+import { computed, ref, defineProps, defineEmits, defineExpose, watch, onMounted, withDefaults } from 'vue'
+import { useQuestions } from './composables/useQuestions'
+import CommonQuestions from './components/CommonQuestions.vue'
+import HotQuestions from './components/HotQuestions.vue'
+import type { Category, Question, QuestionProps, QuestionEmits } from './index.type'
+
+import { IconHotQuestion, IconArrowUp, IconArrowDown, IconTypeAll } from '@opentiny/tiny-robot-svgs'
+import './index.less'
+
+const props = withDefaults(defineProps<QuestionProps>(), {
+  categories: () => [] as Category[],
+  commonQuestions: () => [] as Question[],
+  initialExpanded: false,
+  modalWidth: '640px',
+  theme: 'light',
+  closeOnClickOutside: true,
+  loading: false,
+})
+
+// 切换问题展示
+const toggleExpand = () => {
+  isExpanded.value = !isExpanded.value
+}
+
+const emit = defineEmits<QuestionEmits>()
+
+const categories = computed(() => props.categories)
+const isExpanded = ref(props.initialExpanded)
+
+const { modalVisible, currentTheme, setActiveCategory, openModal, closeModal, setTheme, refreshData } =
+  useQuestions(categories)
+
+// 同步 props 到内部状态
+watch(
+  () => props.theme,
+  (value) => {
+    setTheme(value)
+  },
+)
+
+// 处理问题点击
+const handleQuestionClick = (question: Question) => {
+  closeModal()
+  emit('question-click', question)
+}
+
+// 处理分类选择
+const handleCategorySelect = (category: Category) => {
+  if (category) {
+    setActiveCategory(category.id)
+    emit('select-category', category)
+  }
+}
+
+// 处理按钮隐藏
+const showExpandButton = ref(false)
+
+const handleShowExpandButton = (value: boolean) => {
+  showExpandButton.value = value
+}
+
+// 组件挂载时初始化主题
+onMounted(() => {
+  document.documentElement.setAttribute('data-theme', currentTheme.value)
+})
+
+// 暴露实例方法
+defineExpose({
+  openModal,
+  closeModal,
+  toggleFloating: toggleExpand,
+  setActiveCategory,
+  refreshData,
+})
+</script>
+
+<template>
+  <div class="tr-question-container" :class="[`theme-${theme}`]" :data-theme="theme">
+    <!-- 热门问题弹窗触发按钮 -->
+    <div class="tr-question-trigger" @click="openModal">
+      <IconHotQuestion />
+    </div>
+
+    <!-- 热门问题弹窗 -->
+    <HotQuestions
+      :visible="modalVisible"
+      :categories="categories"
+      :modal-width="modalWidth"
+      :loading="loading"
+      :close-on-click-outside="closeOnClickOutside"
+      @update:visible="modalVisible = $event"
+      @close="modalVisible = false"
+      @question-click="handleQuestionClick"
+      @select-category="handleCategorySelect"
+    >
+      <!-- 传递插槽内容 -->
+      <template #category-label="{ category }">
+        <slot name="category-label" :category="category">
+          <div class="category-icon">
+            <IconTypeAll />
+          </div>
+          <span>{{ category.label }}</span>
+        </slot>
+      </template>
+
+      <template #question-item="{ question, index }">
+        <slot name="question-item" :question="question" :index="index">
+          <span>{{ index + 1 }}.</span> {{ question.text }}
+        </slot>
+      </template>
+
+      <template #loading-indicator>
+        <slot name="loading-indicator">
+          <div class="tr-question-loading-spinner"></div>
+        </slot>
+      </template>
+
+      <template #empty-state>
+        <slot name="empty-state">
+          <p>暂无相关问题</p>
+        </slot>
+      </template>
+    </HotQuestions>
+
+    <!-- 常见问题胶囊 -->
+    <CommonQuestions
+      :isExpanded="isExpanded"
+      :questions="commonQuestions"
+      @show-expand-button="handleShowExpandButton"
+      @question-click="handleQuestionClick"
+    />
+
+    <!-- 常规问题完整内容触发按钮 -->
+    <div v-if="showExpandButton" class="tr-question-wrap-trigger" @click="toggleExpand">
+      <IconArrowUp v-if="!isExpanded" />
+      <IconArrowDown v-else />
+    </div>
+  </div>
+</template>