{
  "schemaVersion": 2,
  "sourceKind": "structured-spec",
  "confidence": "high",
  "slug": "tooltip",
  "name": "文字提示 Tooltip",
  "semanticTypeCandidates": [
    "tooltip",
    "widget"
  ],
  "variantDimensions": [
    {
      "name": "placement",
      "values": [
        "top",
        "right",
        "bottom"
      ]
    },
    {
      "name": "trigger",
      "values": [
        "hover",
        "click"
      ]
    }
  ],
  "representativeVariants": [
    {
      "variant": "default",
      "label": "文字提示 · default"
    },
    {
      "variant": "primary",
      "label": "文字提示 · primary"
    },
    {
      "variant": "compact",
      "label": "文字提示 · compact"
    }
  ],
  "anatomy": {
    "root": "kole-tooltip",
    "content": "文字提示 主体内容",
    "state": "状态类 is-* 与 ARIA 属性同步",
    "overlay": "提示/面板/状态容器与关闭控件"
  },
  "structurePatterns": {
    "root": "kole-tooltip",
    "states": "default / hover / focus / disabled（按组件语义展示）",
    "responsive": "使用 CSS 令牌与 flex/grid，宿主可覆盖容器宽度"
  },
  "usageHints": [
    "解释图标、截断内容或术语，适合短文本的 hover、focus 和键盘提示。",
    "五端保持相同的类名、状态和基础语义。",
    "交互控件优先使用原生元素，受控值变化通过 change 或 v-model 事件传递。"
  ],
  "doNotInvent": [
    "不把本组件扩展为外部依赖提供的完整业务流程。",
    "未声明的高级主题、数据请求和服务端校验不由组件自行推断。"
  ],
  "unknowns": [
    "宿主项目的国际化文案、数据请求和权限策略由接入方决定。"
  ]
}