@yunlefun/vue 0.2.0 → 0.4.0

package/components/YlfTooltip.vue

@@ -2,23 +2,28 @@
 // 行为 / 定位 / a11y 由 reka-ui 提供；皮肤走 token。
 import { TooltipArrow, TooltipContent, TooltipPortal, TooltipProvider, TooltipRoot, TooltipTrigger } from 'reka-ui'
 
+defineOptions({ inheritAttrs: false })
+
 withDefaults(defineProps<{
   content?: string
   side?: 'top' | 'right' | 'bottom' | 'left'
   delay?: number
+  disabled?: boolean
+  portalTo?: string | HTMLElement
 }>(), {
   side: 'top',
   delay: 300,
+  disabled: false,
 })
 </script>
 
 <template>
   <TooltipProvider :delay-duration="delay">
-    <TooltipRoot>
-      <TooltipTrigger as-child>
+    <TooltipRoot :disabled="disabled">
+      <TooltipTrigger as-child v-bind="$attrs">
         <slot />
       </TooltipTrigger>
-      <TooltipPortal>
+      <TooltipPortal :to="portalTo">
         <TooltipContent :side="side" :side-offset="6" class="ylf-tooltip">
           <slot name="content">
             {{ content }}

package/components/accordion/demo.vue

@@ -1,7 +1,7 @@
 <script setup lang="ts">
 const items = [
   { value: 'a', title: '什么是 YunLeFun Design？', content: '云乐坊设计系统，统一设计规范、品牌视觉与 UI 实现；默认晴空蓝为主，高饱和纯色点缀。' },
-  { value: 'b', title: '为什么基于 reka-ui？', content: 'reka 管行为与可访问性，我们只管皮肤——省心，且无障碍达标。' },
+  { value: 'b', title: '为什么基于 reka-ui？', content: 'Reka UI 提供键盘、焦点和 ARIA 行为，云乐坊提供产品接口与主题；封装后的场景仍需逐项验收。' },
   { value: 'c', title: '支持暗色吗？', content: '晴空白与深蓝夜空两套中性色，token 驱动，零配置随主题切换。' },
 ]
 </script>

package/components/accordion/index.md

@@ -17,3 +17,5 @@ title_zh: 手风琴
 ## Slots
 
 每项内容可用 `value` 同名插槽覆盖 `content`。
+
+`items` 支持只读数组。单开模式全部收起时值为 `undefined`，多开模式为字符串数组；调用方应允许收起状态。方向键、Home / End 在标题间移动焦点，跳过禁用项。

package/components/avatar/index.md

@@ -10,6 +10,8 @@ title_zh: 头像
 | 属性       | 说明                   | 类型             | 默认值 |
 | ---------- | ---------------------- | ---------------- | ------ |
 | `src`      | 图片地址               | `string`         | —      |
-| `alt`      | 替代文字               | `string`         | —      |
+| `alt`      | 替代文字               | `string`         | `''`   |
 | `fallback` | 回退文字（如姓名首字） | `string`         | —      |
 | `size`     | 尺寸                   | `sm \| md \| lg` | `md`   |
+
+有意义的头像使用完整 `alt`（例如用户姓名）；图片缺失时，回退图像也使用该名称。没有 `alt` 时回退文字作为名称；仅装饰的图片可保留空 `alt`。`fallback` 决定显示的文字，不会从图片地址自动推断姓名。

package/components/checkbox/demo.vue

@@ -1,28 +1,29 @@
 <script setup lang="ts">
-import { ref } from 'vue'
+import { ref, useId } from 'vue'
 
 const a = ref(true)
 const b = ref(false)
 const c = ref<boolean | 'indeterminate'>('indeterminate')
+const id = useId()
 </script>
 
 <template>
   <div class="flex flex-col gap-4">
     <div class="flex items-center gap-2">
-      <YlfCheckbox v-model="a" />
-      <span class="text-sm">已勾选</span>
+      <YlfCheckbox :id="`${id}-checked`" v-model="a" />
+      <label :for="`${id}-checked`" class="text-sm">已勾选</label>
     </div>
     <div class="flex items-center gap-2">
-      <YlfCheckbox v-model="b" />
-      <span class="text-sm">未勾选</span>
+      <YlfCheckbox :id="`${id}-unchecked`" v-model="b" />
+      <label :for="`${id}-unchecked`" class="text-sm">未勾选</label>
     </div>
     <div class="flex items-center gap-2">
-      <YlfCheckbox v-model="c" />
-      <span class="text-sm">半选 indeterminate</span>
+      <YlfCheckbox :id="`${id}-mixed`" v-model="c" />
+      <label :for="`${id}-mixed`" class="text-sm">半选 indeterminate</label>
     </div>
     <div class="flex items-center gap-2 op-60">
-      <YlfCheckbox :model-value="true" disabled />
-      <span class="text-sm">禁用</span>
+      <YlfCheckbox :id="`${id}-disabled`" :model-value="true" disabled />
+      <label :for="`${id}-disabled`" class="text-sm">禁用</label>
     </div>
   </div>
 </template>

package/components/checkbox/index.md

@@ -12,3 +12,5 @@ title_zh: 复选框
 | `v-model`  | 勾选状态   | `boolean \| 'indeterminate'` | `false` |
 | `value`    | 表单提交值 | `string`                     | —       |
 | `disabled` | 禁用       | `boolean`                    | `false` |
+
+每个复选框必须有可访问名称：传入 `aria-label="同意服务条款"`，或通过 `id` 与 `<label for>` 关联。旁边的普通 `<span>` 不会自动成为标签。`name` 和 `required` 透传给 Reka UI；置于原生表单时，勾选值进入 `FormData`，禁用项不提交。

package/components/dialog/index.md

@@ -7,15 +7,18 @@ title_zh: 对话框
 
 ## Props
 
-| 属性              | 说明                             | 类型      | 默认值     |
-| ----------------- | -------------------------------- | --------- | ---------- |
-| `v-model:open`    | 显隐状态                         | `boolean` | `false`    |
-| `title`           | 可见标题                         | `string`  | —          |
-| `description`     | 描述                             | `string`  | —          |
-| `accessibleTitle` | 无可见标题时供辅助技术读取的标题 | `string`  | `'对话框'` |
+| 属性              | 说明                             | 类型                    | 默认值                  |
+| ----------------- | -------------------------------- | ----------------------- | ----------------------- |
+| `v-model:open`    | 显隐状态                         | `boolean`               | `false`                 |
+| `title`           | 可见标题                         | `string`                | —                       |
+| `description`     | 描述                             | `string`                | —                       |
+| `accessibleTitle` | 无可见标题时供辅助技术读取的标题 | `string`                | `'对话框'`              |
+| `portalTo`        | 已存在的主题内浮层容器           | `string \| HTMLElement` | ConfigProvider / `body` |
 
 建议始终提供 `title`。只有视觉设计明确隐藏标题时，才改用描述场景的 `accessible-title`。
 
+`class`、`id`、`data-*` 和事件传给对话框内容；显式的 `aria-describedby` 可关联调用方的说明。焦点陷阱、Escape 关闭和关闭后回到触发器仍由 Reka UI 管理。局部主题中把 `portal-to` 指向同一主题边界内的容器。长标题会换行并为关闭按钮保留空间。
+
 ## Registry
 
 Dialog 可通过 [Registry 分发](/guide/registry)复制源码；安装时会自动带入 `reka-ui`、Sass 与共享 token。

package/components/dropdown-menu/index.md

@@ -7,9 +7,13 @@ title_zh: 下拉菜单
 
 ## Props
 
-| 属性    | 说明   | 类型         | 默认值 |
-| ------- | ------ | ------------ | ------ |
-| `items` | 菜单项 | `MenuItem[]` | —      |
+| 属性           | 说明                   | 类型                    | 默认值                  |
+| -------------- | ---------------------- | ----------------------- | ----------------------- |
+| `items`        | 菜单项                 | `readonly MenuItem[]`   | —                       |
+| `v-model:open` | 显隐状态               | `boolean`               | `false`                 |
+| `portalTo`     | 已存在的主题内浮层容器 | `string \| HTMLElement` | ConfigProvider / `body` |
+
+`class`、`data-*`、ARIA 属性和事件传给菜单内容。`portal-to` 可把菜单放入已有的局部主题容器；未传时继续使用 ConfigProvider 或 `body`。支持方向键、Home / End、Enter 选择和 Escape 关闭；禁用项会被跳过。
 
 ### MenuItem
 
@@ -25,3 +29,5 @@ title_zh: 下拉菜单
 | 名称     | 说明                         |
 | -------- | ---------------------------- |
 | `select` | 选中某项时触发，回传 `value` |
+
+`value=""` 可表示“全部”或“清除筛选”，仍会触发 `select`。没有 `value` 的项不触发选值事件。

package/components/popover/demo.vue

@@ -1,5 +1,5 @@
 <template>
-  <YlfPopover side="bottom" align="start">
+  <YlfPopover side="bottom" align="start" aria-label="云乐坊介绍">
     <template #trigger>
       <YlfButton variant="primary">
         打开浮层

package/components/popover/index.md

@@ -7,11 +7,14 @@ title_zh: 浮层
 
 ## Props
 
-| 属性           | 说明     | 类型                             | 默认值   |
-| -------------- | -------- | -------------------------------- | -------- |
-| `v-model:open` | 显隐状态 | `boolean`                        | `false`  |
-| `side`         | 方向     | `top \| right \| bottom \| left` | `bottom` |
-| `align`        | 对齐     | `start \| center \| end`         | `center` |
+| 属性           | 说明                   | 类型                             | 默认值                  |
+| -------------- | ---------------------- | -------------------------------- | ----------------------- |
+| `v-model:open` | 显隐状态               | `boolean`                        | `false`                 |
+| `side`         | 方向                   | `top \| right \| bottom \| left` | `bottom`                |
+| `align`        | 对齐                   | `start \| center \| end`         | `center`                |
+| `portalTo`     | 已存在的主题内浮层容器 | `string \| HTMLElement`          | ConfigProvider / `body` |
+
+`class`、`data-*`、ARIA 属性和事件传给浮层内容，内部关联 ID 由 Reka UI 管理。默认可访问名称与触发器关联；触发器应使用说明用途的文字。局部主题的 `portal-to` 容器应处于相同主题边界。
 
 ## Slots
 

package/components/progress/index.md

@@ -9,9 +9,11 @@ title_zh: 进度条
 
 | 属性      | 说明                      | 类型                                            | 默认值  |
 | --------- | ------------------------- | ----------------------------------------------- | ------- |
-| `value`   | 当前进度                  | `number`                                        | `0`     |
+| `value`   | 当前进度；`null` 表示未知 | `number \| null`                                | `0`     |
 | `max`     | 最大值                    | `number`                                        | `100`   |
 | `variant` | 填充                      | `brand \| accent`                               | `brand` |
 | `tone`    | 强调色，仅作用于 `accent` | `blue \| sun \| cyan \| coral \| pink \| green` | `blue`  |
 
 `tone` 接受 `blue | sun | cyan | coral | pink | green`，默认 `blue`（晴空蓝），只在 `accent` 下生效。旧 `aurora` 值映射到 `accent`。同一流程中的同类状态使用同一种颜色。
+
+提供用途名称，例如 `aria-label="文件上传进度"`。有限数值会限制在 `0…max`，无效的 `max` 回退到 `100`，确保显示与 ARIA 值一致。`null`、NaN 或无限值按未知进度显示，不输出 `aria-valuenow`；减少动态效果时显示静态进度段。

package/components/radio/demo.vue

@@ -12,7 +12,7 @@ const options = [
 
 <template>
   <div class="flex flex-col gap-4">
-    <YlfRadioGroup v-model="picked" :options="options" orientation="horizontal" />
+    <YlfRadioGroup v-model="picked" :options="options" orientation="horizontal" aria-label="主题颜色" />
     <p class="text-sm op-70">
       当前：{{ picked }}
     </p>

package/components/radio/index.md

@@ -21,3 +21,5 @@ title_zh: 单选框
 | `label`    | 文案     | `string`   |
 | `value`    | 值       | `string`   |
 | `disabled` | 禁用该项 | `boolean?` |
+
+`options` 支持只读数组。通过 `aria-label` 或 `aria-labelledby` 指定整组名称，单项名称来自 `label`。方向键跳过禁用项；`name` / `required` 透传给 Reka UI，可用于原生表单。

package/components/segmented-control/demo.vue

@@ -0,0 +1,21 @@
+<script setup lang="ts">
+import { shallowRef } from 'vue'
+import YlfSegmentedControl from '../YlfSegmentedControl.vue'
+
+const view = shallowRef<'grid' | 'list'>('grid')
+const kind = shallowRef('all')
+const options = [{ value: 'grid', label: '网格视图' }, { value: 'list', label: '列表视图' }] as const
+const icons = { grid: 'i-ri-grid-line', list: 'i-ri-list-check' }
+const kinds = [{ value: 'all', label: '全部', count: 24 }, { value: 'image', label: '图片', count: 18 }, { value: 'video', label: '视频', count: 6 }]
+</script>
+
+<template>
+  <div class="flex flex-wrap items-center gap-4">
+    <YlfSegmentedControl v-model="kind" :options="kinds" label="素材类型" size="sm" />
+    <YlfSegmentedControl v-model="view" :options="options" label="资源视图" size="sm" icon-only>
+      <template #icon="{ option }">
+        <i :class="icons[option.value]" />
+      </template>
+    </YlfSegmentedControl>
+  </div>
+</template>

package/components/segmented-control/index.md

@@ -0,0 +1,41 @@
+---
+title: Segmented Control
+title_zh: 分段选择器
+---
+
+单选视图与筛选控件，基于 [Reka UI ToggleGroup](https://reka-ui.com/docs/components/toggle-group)。保留方向键、Home / End 和禁用项处理，再次点击当前项不会清空选择。切换独立内容面板请使用 Tabs。
+
+| 属性        | 说明                                                              | 默认值  |
+| ----------- | ----------------------------------------------------------------- | ------- |
+| `v-model`   | 当前选项，支持字符串联合类型                                      | 必填    |
+| `options`   | `{ value, label, disabled?, count?, ariaLabel? }[]`，支持只读数组 | 必填    |
+| `label`     | 组合控件的无障碍名称                                              | 必填    |
+| `size`      | `sm`：34px 工作台；`md`：44px 常规界面                            | `md`    |
+| `icon-only` | 仅显示图标，并提供文字 Tooltip                                    | `false` |
+| `disabled`  | 禁用全部选项                                                      | `false` |
+
+`#icon="{ option, selected }"` 插槽接收当前项及选中状态。应用通过完整的 UnoCSS / Iconify 类名映射渲染图标，公共组件不依赖应用的图标构建方式。没有图标插槽时仍显示标签。
+
+```vue
+<script setup lang="ts">
+import YlfSegmentedControl from '@yunlefun/vue/components/YlfSegmentedControl.vue'
+import { shallowRef } from 'vue'
+
+const view = shallowRef<'grid' | 'list'>('grid')
+const options = [
+  { value: 'grid', label: '网格视图' },
+  { value: 'list', label: '列表视图' },
+] as const
+const icons = { grid: 'i-ri-grid-line', list: 'i-ri-list-check' }
+</script>
+
+<template>
+  <YlfSegmentedControl v-model="view" :options="options" label="资源视图" size="sm" icon-only>
+    <template #icon="{ option }">
+      <i :class="icons[option.value]" />
+    </template>
+  </YlfSegmentedControl>
+</template>
+```
+
+样式统一来自 `--ylf-*`：轻灰底座、表面色选中项、品牌色文字、细边框与焦点环。`sm` 与 `YlfSelect size="sm"` 对齐。触摸设备中选项至少 44px；减少动态效果时禁用过渡。不需要在业务页面覆盖选中态或圆角。

package/components/segmented-control.ts

@@ -0,0 +1,8 @@
+/** One choice in a single-selection segmented control. */
+export interface YlfSegmentedOption<T extends string = string> {
+  value: T
+  label: string
+  disabled?: boolean
+  count?: number
+  ariaLabel?: string
+}

package/components/select/index.md

@@ -39,3 +39,13 @@ const options = [
 ```
 
 使用 token 时，色点会随所在主题更新；页面和浮层需处于同一主题范围。
+
+## 工作台密度与图标
+
+`size="sm"` 使用 34px 高度、紧凑文字与 10px 圆角，适合排序、项目范围等工具栏控件；默认 `md` 保持 44px 表单尺寸。触摸设备中紧凑选择器与选项仍至少 44px。`#icon` 和 `#indicator` 可传入应用已有的 UnoCSS / Iconify 图标；未提供时保留内置 SVG。
+
+## 表单与局部主题
+
+`name?: string` 和 `required?: boolean`（默认 `false`）传给底层表单控件。放在 `<form>` 内时，选择值进入原生 `FormData`；禁用字段不提交。`id`、`aria-label`、`aria-labelledby`、`class` 和事件传给触发按钮。使用实际字段名称作为可访问名称，例如 `aria-label="主题颜色"` 或关联的 `<label for>`。
+
+`portalTo?: string | HTMLElement` 指定已存在的浮层容器，例如 `portal-to="#settings-portals"`。容器应位于页面相同的 `.ylf-theme-light` / `.ylf-theme-dark` 边界中。不传时保留 Reka UI 的 ConfigProvider 配置，最终回退到 `body`。

package/components/slider/demo.vue

@@ -8,13 +8,13 @@ const range = ref([20, 70])
 <template>
   <div class="flex flex-col gap-6">
     <div class="flex flex-col gap-2">
-      <YlfSlider v-model="single" />
+      <YlfSlider v-model="single" label="音量" />
       <p class="m-0 text-sm op-70">
         单值：{{ single[0] }}
       </p>
     </div>
     <div class="flex flex-col gap-2">
-      <YlfSlider v-model="range" />
+      <YlfSlider v-model="range" label="价格区间" :thumb-labels="['最低价格', '最高价格']" />
       <p class="m-0 text-sm op-70">
         区间：{{ range[0] }} – {{ range[1] }}
       </p>

package/components/slider/index.md

@@ -7,10 +7,18 @@ title_zh: 滑块
 
 ## Props
 
-| 属性       | 说明   | 类型       | 默认值  |
-| ---------- | ------ | ---------- | ------- |
-| `v-model`  | 当前值 | `number[]` | `[50]`  |
-| `min`      | 最小值 | `number`   | `0`     |
-| `max`      | 最大值 | `number`   | `100`   |
-| `step`     | 步长   | `number`   | `1`     |
-| `disabled` | 禁用   | `boolean`  | `false` |
+| 属性          | 说明                     | 类型                | 默认值  |
+| ------------- | ------------------------ | ------------------- | ------- |
+| `v-model`     | 当前值                   | `number[]`          | `[50]`  |
+| `min`         | 最小值                   | `number`            | `0`     |
+| `max`         | 最大值                   | `number`            | `100`   |
+| `step`        | 步长                     | `number`            | `1`     |
+| `disabled`    | 禁用                     | `boolean`           | `false` |
+| `label`       | 单值或整组用途名称       | `string`            | `数值`  |
+| `thumbLabels` | 按顺序指定每个滑块的名称 | `readonly string[]` | —       |
+
+单值使用 `label="音量"`；区间使用 `:thumb-labels="['最低价格', '最高价格']"`。未指定端点名称时，使用 `label` 和顺序编号。方向键按 `step` 调整，Home / End 到达边界；禁用时滑块不进入键盘焦点顺序。触摸设备提供至少 44px 的操作区域，减少动态效果时关闭过渡。
+
+## Events
+
+`valueCommit` 在一次拖动或键盘调整完成时回传 `number[]`。需要在交互完成后保存数据时，使用 `@value-commit`；界面状态继续使用 `v-model`。

package/components/switch/index.md

@@ -16,3 +16,5 @@ title_zh: 开关
 | `disabled` | 禁用                      | `boolean`                                       | `false` |
 
 `tone` 接受 `blue | sun | cyan | coral | pink | green`，默认 `blue`（晴空蓝），只在 `accent` 下生效。旧 `aurora` 值映射到 `accent`。同一流程中的同类状态使用同一种颜色。
+
+通过 `aria-label` 或关联的 `<label for>` 提供用途名称。Space / Enter 切换状态，禁用时不响应操作。`name`、`value` 和 `required` 透传给 Reka UI，用于原生表单提交。

package/components/tabs/index.md

@@ -16,3 +16,5 @@ title_zh: 标签页
 ## Slots
 
 每个标签的内容用 `value` 同名插槽提供，如 `#cloud`、`#fun`。
+
+`items` 支持只读数组。标签和内容面板的 ARIA 关联由 Reka UI 管理；方向键、Home / End 改变焦点并自动选中，跳过禁用项。切换普通筛选条件而不展示关联面板时使用 Segmented Control。

package/components/tooltip/index.md

@@ -7,11 +7,15 @@ title_zh: 文字提示
 
 ## Props
 
-| 属性      | 说明       | 类型                             | 默认值 |
-| --------- | ---------- | -------------------------------- | ------ |
-| `content` | 提示文字   | `string`                         | —      |
-| `side`    | 方向       | `top \| right \| bottom \| left` | `top`  |
-| `delay`   | 延迟（ms） | `number`                         | `300`  |
+| 属性       | 说明                   | 类型                             | 默认值                  |
+| ---------- | ---------------------- | -------------------------------- | ----------------------- |
+| `content`  | 提示文字               | `string`                         | —                       |
+| `side`     | 方向                   | `top \| right \| bottom \| left` | `top`                   |
+| `delay`    | 延迟（ms）             | `number`                         | `300`                   |
+| `disabled` | 关闭提示               | `boolean`                        | `false`                 |
+| `portalTo` | 已存在的主题内浮层容器 | `string \| HTMLElement`          | ConfigProvider / `body` |
+
+`id`、`class`、`aria-label`、`data-*` 和事件传给触发元素。仅图标按钮仍需可访问名称，不能只依赖 Tooltip 内容。局部主题中使用 `portal-to` 保持提示与触发器处于同一主题。
 
 ## Slots
 
@@ -19,3 +23,5 @@ title_zh: 文字提示
 | --------- | ---------------------- |
 | `default` | 触发元素（`as-child`） |
 | `content` | 自定义提示内容         |
+
+`disabled` 可关闭 Tooltip；例如分段选择器显示文字时不重复提示，仅图标模式下再启用。

package/dist/components/YlfAccordion.vue.d.ts

@@ -0,0 +1,35 @@
+interface AccordionItemData {
+    value: string;
+    title: string;
+    content?: string;
+    disabled?: boolean;
+}
+type __VLS_Props = {
+    items: readonly AccordionItemData[];
+    type?: 'single' | 'multiple';
+    collapsible?: boolean;
+};
+type __VLS_ModelProps = {
+    modelValue?: string | string[];
+};
+type __VLS_PublicProps = __VLS_Props & __VLS_ModelProps;
+declare var __VLS_33: string, __VLS_34: {};
+type __VLS_Slots = {} & {
+    [K in NonNullable<typeof __VLS_33>]?: (props: typeof __VLS_34) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    "update:modelValue": (value: string | string[] | undefined) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    "onUpdate:modelValue"?: ((value: string | string[] | undefined) => any) | undefined;
+}>, {
+    type: "single" | "multiple";
+    collapsible: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/YlfAiPromptLauncher.vue.d.ts

@@ -0,0 +1,25 @@
+import type { AiPromptLaunch, AiPromptLaunchResult, AiPromptOptions, AiProviderId } from './ai-prompt';
+type __VLS_Props = {
+    prompt: string;
+    providers?: readonly AiProviderId[];
+    disabled?: boolean;
+    locale?: 'zh-CN' | 'en';
+    options?: AiPromptOptions;
+    /** Optional host adapter, e.g. a validated desktop IPC call. */
+    launch?: AiPromptLaunch;
+    /** Optional native clipboard adapter. */
+    copyText?: (text: string) => Promise<void>;
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    result: (result: AiPromptLaunchResult) => any;
+    busy: (value: boolean) => any;
+    manualCopy: (prompt: string) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onResult?: ((result: AiPromptLaunchResult) => any) | undefined;
+    onBusy?: ((value: boolean) => any) | undefined;
+    onManualCopy?: ((prompt: string) => any) | undefined;
+}>, {
+    locale: "zh-CN" | "en";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/YlfAvatar.vue.d.ts

@@ -0,0 +1,14 @@
+type __VLS_Props = {
+    src?: string;
+    alt?: string;
+    /** 图片加载失败/缺省时显示的文字（如姓名首字） */
+    fallback?: string;
+    size?: 'sm' | 'md' | 'lg';
+};
+declare const __VLS_export: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    fallback: string;
+    alt: string;
+    size: "sm" | "md" | "lg";
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/YlfBadge.vue.d.ts

@@ -0,0 +1,29 @@
+import type { YlfAccentTone, YlfColorAppearance } from './theme';
+type BadgeVariant = 'featured' | 'accent' | 'aurora' | 'brand' | 'neutral' | 'success' | 'warning' | 'danger' | 'info';
+type __VLS_Props = {
+    variant?: BadgeVariant;
+    /** 仅 accent 变体使用 */
+    tone?: YlfAccentTone;
+    /** accent 与状态变体的强调程度 */
+    appearance?: YlfColorAppearance;
+    /** 胶囊圆角 */
+    round?: boolean;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    round: boolean;
+    variant: BadgeVariant;
+    tone: YlfAccentTone;
+    appearance: YlfColorAppearance;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/YlfBottomMenu.vue.d.ts

@@ -0,0 +1,19 @@
+type __VLS_Props = {
+    /** 浮起阴影 */
+    shadow?: boolean;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    shadow: boolean;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/YlfBottomMenuItem.vue.d.ts

@@ -0,0 +1,22 @@
+import type { BottomMenuItem } from './bottom-menu';
+type __VLS_Props = {
+    active: boolean;
+    item: BottomMenuItem;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (...args: any[]) => void;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((...args: any[]) => any) | undefined;
+}>, {}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/YlfButton.vue.d.ts

@@ -0,0 +1,48 @@
+import type { YlfAccentTone, YlfColorAppearance } from './theme';
+type ButtonVariant = 'primary' | 'accent' | 'aurora' | 'secondary' | 'soft' | 'ghost' | 'success' | 'warning' | 'danger';
+type ButtonSize = 'sm' | 'md' | 'lg';
+type __VLS_Props = {
+    variant?: ButtonVariant;
+    /** 仅 accent 变体使用，默认晴空蓝 */
+    tone?: YlfAccentTone;
+    /** accent 与状态变体的强调程度 */
+    appearance?: YlfColorAppearance;
+    size?: ButtonSize;
+    /** 胶囊圆角，默认开启（云是软的） */
+    round?: boolean;
+    /** 占满整行宽度 */
+    block?: boolean;
+    disabled?: boolean;
+    loading?: boolean;
+    /** 渲染标签，如 'a' */
+    tag?: string;
+};
+declare var __VLS_10: {}, __VLS_12: {};
+type __VLS_Slots = {} & {
+    icon?: (props: typeof __VLS_10) => any;
+} & {
+    default?: (props: typeof __VLS_12) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {
+    click: (e: MouseEvent) => any;
+}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{
+    onClick?: ((e: MouseEvent) => any) | undefined;
+}>, {
+    disabled: boolean;
+    round: boolean;
+    size: ButtonSize;
+    variant: ButtonVariant;
+    tone: YlfAccentTone;
+    appearance: YlfColorAppearance;
+    block: boolean;
+    loading: boolean;
+    tag: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};

package/dist/components/YlfCard.vue.d.ts

@@ -0,0 +1,28 @@
+import type { YlfAccentTone } from './theme';
+type CardVariant = 'soft' | 'glass' | 'accent' | 'tinted' | 'gradient';
+type __VLS_Props = {
+    variant?: CardVariant;
+    tone?: YlfAccentTone;
+    /** 悬停时轻轻抬升 */
+    hoverable?: boolean;
+    /** 内边距，接受任意 CSS 值 */
+    padding?: string;
+};
+declare var __VLS_1: {};
+type __VLS_Slots = {} & {
+    default?: (props: typeof __VLS_1) => any;
+};
+declare const __VLS_base: import("vue").DefineComponent<__VLS_Props, {}, {}, {}, {}, import("vue").ComponentOptionsMixin, import("vue").ComponentOptionsMixin, {}, string, import("vue").PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {
+    variant: CardVariant;
+    tone: YlfAccentTone;
+    hoverable: boolean;
+    padding: string;
+}, {}, {}, {}, string, import("vue").ComponentProvideOptions, false, {}, any>;
+declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
+declare const _default: typeof __VLS_export;
+export default _default;
+type __VLS_WithSlots<T, S> = T & {
+    new (): {
+        $slots: S;
+    };
+};