@veltra/mobile 1.0.0 → 1.1.0

package/src/types/password-input.ts

@@ -0,0 +1,19 @@
+import type { DeconstructValue } from '@veltra/utils'
+
+import type { InputProps } from './input'
+
+/** 密码输入组件属性（API 与 @veltra/desktop UPasswordInput 对齐；明文切换按钮 44px 触控热区为移动端形态） */
+export interface PasswordInputProps extends InputProps {
+  modelValue?: string
+}
+
+/** 密码输入组件定义的事件 */
+export interface PasswordInputEmits {
+  (e: 'update:modelValue', value: string): void
+}
+
+/** 密码输入暴露的属性和方法(组件内部使用) */
+export interface _PasswordInputExposed {}
+
+/** 密码输入暴露的属性和方法(组件外部使用, 引用的值会被自动解构) */
+export type PasswordInputExposed = DeconstructValue<_PasswordInputExposed>

package/src/types/progress.ts

@@ -0,0 +1,22 @@
+import type { ColorType, DeconstructValue } from '@veltra/utils'
+
+/** progress组件属性 */
+export interface ProgressProps {
+  /** 类型 */
+  type: ColorType | ((percentage: number) => ColorType)
+  /** 圆形进度条尺寸 */
+  size?: number | string
+  /** 进度百分比 */
+  percentage?: number
+  /** 是否圆形进度条 */
+  circle?: boolean
+}
+
+/** progress组件定义的事件 */
+export interface ProgressEmits {}
+
+/** progress组件暴露的属性和方法(组件内部使用) */
+export interface _ProgressExposed {}
+
+/** progress组件暴露的属性和方法(组件外部使用, 引用的值会被自动解构) */
+export type ProgressExposed = DeconstructValue<_ProgressExposed>

package/src/types/radio-group.ts

@@ -0,0 +1,33 @@
+import type { FormComponentProps } from '@veltra/utils'
+
+/** 单选框组组件属性（移动端列表行式：选项纵向排列占满整行，选中标记在行右侧） */
+export interface RadioGroupProps extends FormComponentProps {
+  /** 值 */
+  modelValue?: any
+  /** 单选框项 */
+  items: Record<string, any>[]
+  /**
+   * 选项值key
+   * @default 'value'
+   */
+  valueKey?: string
+  /**
+   * 标签文本key
+   * @default 'label'
+   */
+  labelKey?: string
+  /** 禁用 */
+  disabled?: boolean
+  /** 禁用的选项 */
+  disabledItem?: (item: Record<string, any>) => boolean
+  /** 选项行间细分隔线。默认 false */
+  divider?: boolean
+}
+
+/** 单选框组组件定义的事件 */
+export interface RadioGroupEmits {
+  /** 值更新 */
+  (e: 'update:modelValue', modelValue: any): void
+  /** 选项更新事件 */
+  (e: 'change', item: Record<string, any>): void
+}

package/src/types/radio.ts

@@ -0,0 +1,18 @@
+import type { FormComponentProps } from '@veltra/utils'
+
+/** 单选框组件属性（与 @veltra/desktop URadio 同名；呈移动端列表行式选项形态，选中标记在行右侧） */
+export interface RadioProps extends FormComponentProps {
+  /** 单选框值 */
+  value?: any
+  /** 文本 */
+  label?: string
+  /**全部禁用 */
+  disabled?: boolean
+  /** 绑定值 */
+  modelValue?: any
+}
+
+/** 单选框组件定义的事件 */
+export interface RadioEmits {
+  (e: 'update:modelValue', value: any): void
+}

package/src/types/segment.ts

@@ -0,0 +1,42 @@
+import type { DeconstructValue, FormComponentProps } from '@veltra/utils'
+
+/** 分段单选选项 */
+export type SegmentItem = Record<string, any>
+
+/** 分段单选组件属性 */
+export interface SegmentProps extends FormComponentProps {
+  /** 绑定值 */
+  modelValue?: any
+  /** 选项列表 */
+  items: SegmentItem[]
+  /**
+   * 选项值 key
+   * @default 'value'
+   */
+  valueKey?: string
+  /**
+   * 选项标签 key
+   * @default 'label'
+   */
+  labelKey?: string
+  /** 是否禁用整组 */
+  disabled?: boolean
+  /** 禁用的选项判断函数 */
+  disabledItem?: (item: SegmentItem) => boolean
+  /** 是否撑满容器宽度 */
+  block?: boolean
+}
+
+/** 分段单选组件事件 */
+export interface SegmentEmits {
+  /** 绑定值更新 */
+  (e: 'update:modelValue', modelValue: any): void
+  /** 选中项切换事件 */
+  (e: 'change', item: SegmentItem): void
+}
+
+/** 分段单选组件暴露的属性和方法(组件内部使用) */
+export interface _SegmentExposed {}
+
+/** 分段单选组件暴露的属性和方法(组件外部使用, 引用的值会被自动解构) */
+export type SegmentExposed = DeconstructValue<_SegmentExposed>

package/src/types/select.ts

@@ -0,0 +1,63 @@
+import type { FormComponentProps } from '@veltra/utils'
+import type { CSSProperties } from 'vue'
+
+/** 选择器组件属性（移动端形态：面板走 BottomSheet） */
+export interface SelectProps extends FormComponentProps {
+  /** 绑定值 */
+  modelValue?: any
+  /**
+   * 列表选项
+   * @description 如果传入一个函数，那么filterable会被强制启用
+   */
+  options?:
+    | Record<string, any>[]
+    | ((qs: string) => Promise<Record<string, any>[]> | Record<string, any>[])
+  /** 值字段 */
+  valueKey?: string
+  /** 标签字段 */
+  labelKey?: string
+  /**
+   * 兜底展示文案
+   * @description modelValue 未命中选项时展示 text（如回显数据已不在选项中），命中时展示选项 label
+   */
+  text?: string
+  /** 是否可清除 */
+  clearable?: boolean
+  /** 占位符 */
+  placeholder?: string
+  /** 是否启用搜索功能 */
+  filterable?: boolean
+  /** 底部面板内容容器样式 */
+  contentStyle?: CSSProperties | string
+  /** 底部面板内容容器类名 */
+  contentClass?: unknown
+  /** 是否允许创建新的选项 */
+  creatable?: boolean
+
+  /**
+   * 配置网格布局
+   *
+   * - 开启网格布局将会导致虚拟滚动失效，因此网格布局不适合大量数据
+   * @example
+   * ```ts
+   * const grid = true
+   * // 或者
+   * const grid = {
+   *   cols: 12,
+   *   gap: 10
+   * }
+   * ```
+   */
+  grid?: { cols: number; gap?: number }
+}
+
+export interface SelectEmits {
+  /**
+   * 选中项文案变化（用于同步父级冗余字段）
+   * @description 命中选项时发出 label，清空时发出 undefined；未命中选项时，
+   * 传了 text 兜底则不发出（父级文案已是事实来源），未传 text 时发出 undefined；readonly 下不发出
+   */
+  (e: 'update:text', text?: string): void
+  (e: 'update:modelValue', modelValue?: any): void
+  (e: 'change', option?: Record<string, any>): void
+}

package/src/types/skeleton.ts

@@ -0,0 +1,29 @@
+/** 骨架屏组件属性 */
+export interface SkeletonProps {
+  /** 是否处于加载态；false 时渲染默认插槽的实际内容，默认 true */
+  loading?: boolean
+
+  /** 是否显示头像占位块，默认 false */
+  avatar?: boolean
+
+  /** 是否显示标题占位块，默认 true */
+  title?: boolean
+
+  /** 是否显示段落占位块，默认 true */
+  paragraph?: boolean
+
+  /** 段落占位块行数，默认 3 */
+  rows?: number
+
+  /** 是否显示按钮形态占位块，默认 false */
+  button?: boolean
+
+  /** 是否使用胶囊圆角，作用于标题 / 段落 / 按钮占位块，默认 false */
+  round?: boolean
+
+  /** 是否开启呼吸动画，默认 false */
+  animated?: boolean
+}
+
+/** 骨架屏组件定义的事件 */
+export interface SkeletonEmits {}

package/src/types/space.ts

@@ -0,0 +1,22 @@
+import type { ComponentSize } from '@veltra/utils'
+
+/** 间距容器组件属性 */
+export interface SpaceProps {
+  /**
+   * 间距：档位走 `--um-*` 间距刻度 token（small 8px / default 12px / large 16px）；
+   * 数字为固定间距（px）；二元组为 [水平间距, 垂直间距]（px）。默认 'default'
+   */
+  size?: ComponentSize | number | [number, number]
+
+  /** 排列方向，默认 'horizontal' */
+  direction?: 'horizontal' | 'vertical'
+
+  /** 交叉轴对齐方式，默认 'center' */
+  align?: 'start' | 'center' | 'end' | 'baseline'
+
+  /** 是否自动换行，仅水平方向生效，默认 false */
+  wrap?: boolean
+}
+
+/** 间距容器组件定义的事件 */
+export interface SpaceEmits {}

package/src/types/steps.ts

@@ -0,0 +1,67 @@
+import type { ColorType, ComponentSize, DeconstructValue } from '@veltra/utils'
+
+/** 步骤组件组件属性 */
+export interface StepsProps {
+  /**
+   * 当前步骤项，默认为步骤的索引
+   */
+  current?: string | number
+  /**
+   * 尺寸
+   */
+  size?: ComponentSize
+  /**
+   * 步骤项
+   */
+  items: Record<string, any>[]
+  /** 步骤项标签键 */
+  labelKey?: string
+  /**
+   * 当前步骤项键
+   * @description
+   * 如果指定，则current的值会作为items中的键值来获取当前步骤项
+   */
+  currentKey?: string
+  /**
+   * 方向
+   * @default 'horizontal'
+   */
+  direction?: 'horizontal' | 'vertical'
+
+  /** 居中对齐 */
+  alignCenter?: boolean
+
+  /**
+   * 当前步骤项颜色类型
+   */
+  currentStepType?: ColorType
+  /**
+   * 已完成项步骤颜色类型
+   * @default 'success'
+   */
+  finishedStepType?: ColorType
+}
+
+/** 步骤项插槽作用域 */
+export interface StepsSlotScope {
+  item: Record<string, any>
+  index: number
+}
+
+/** 步骤组件组件定义的事件 */
+export interface StepsEmits {
+  /**
+   * 当前步骤项变更
+   */
+  (e: 'update:current', value?: string | number): void
+  /**
+   * 步骤项点击事件
+   */
+  (e: 'item-click', item: Record<string, any>, index: number): void
+}
+
+/** 步骤组件组件暴露的属性和方法(组件内部使用) */
+export interface _StepsExposed {}
+
+/** 步骤组件组件暴露的属性和方法(组件外部使用, 引用的值会被自动解构) */
+export type StepsExposed = DeconstructValue<_StepsExposed>

package/src/types/switch.ts

@@ -0,0 +1,17 @@
+import type { FormComponentProps } from '@veltra/utils'
+
+/** 开关组件属性（与 @veltra/desktop USwitch 同名；轨道/手柄尺寸走 `--um-*` 移动档） */
+export interface SwitchProps extends FormComponentProps {
+  /** 开关状态 */
+  modelValue?: boolean
+  /** 打开时显示的文字 */
+  activeText?: string
+  /** 关闭时显示的文字 */
+  inactiveText?: string
+}
+
+/** 开关组件定义的事件 */
+export interface SwitchEmits {
+  (e: 'update:modelValue', value: boolean): void
+  (e: 'change', value: boolean): void
+}

package/src/types/tabs.ts

@@ -0,0 +1,63 @@
+import type { ComponentProps } from '@veltra/utils'
+
+export type TabItem = {
+  /**
+   * 标题名称
+   * @description 如果不传则以 key 为名称
+   */
+  name?: string
+  /** 标签页唯一标识 */
+  key: string
+  /** 是否禁用 */
+  disabled?: boolean
+  /**
+   * 单个标签是否可关闭
+   * @description 未显式设置时，沿用组件级 `closable` 属性
+   */
+  closable?: boolean
+}
+
+/** 标签页组件属性 */
+export interface TabsProps extends ComponentProps {
+  /** 当前激活的标签 key */
+  modelValue?: string
+  /** 标签项 */
+  items: TabItem[]
+  /**
+   * 是否可关闭
+   * @description 作为所有 TabItem 未显式 `closable` 时的默认值；禁用项不显示关闭按钮
+   * @default false
+   */
+  closable?: boolean
+  /**
+   * 是否填充父容器宽度（仅在 position=top/bottom 时生效）
+   * @description 开启时 header 容器占满父容器宽度，背景完整铺开；tab-item 自身宽度保持不变
+   * @default false
+   */
+  block?: boolean
+  /**
+   * 是否开启圆角胶囊风格
+   * @default false
+   */
+  rounded?: boolean
+  /** 显示位置 */
+  position?: 'left' | 'right' | 'top' | 'bottom'
+  /**
+   * 是否保活
+   * @default false
+   */
+  keepAlive?: boolean
+}
+
+/** 标签页组件定义的事件 */
+export interface TabsEmits {
+  (e: 'update:modelValue', value: string): void
+  (e: 'click', item: TabItem, index: number): void
+  (e: 'close', item: TabItem, index: number): void
+}
+
+/** 标签页组件暴露的属性和方法（组件内部使用） */
+export interface _TabsExposed {}
+
+/** 标签页组件暴露的属性和方法（组件外部使用，引用的值会被自动解构） */
+export interface TabsExposed {}

package/src/types/tag.ts

@@ -0,0 +1,19 @@
+import type { ColorType, ComponentSize } from '@veltra/utils'
+
+/** 标签组件属性 */
+export interface TagProps {
+  type?: ColorType
+  /** 是否可移除 */
+  closable?: boolean
+  /** 尺寸大小 */
+  size?: ComponentSize
+  /** 是否为圆角 */
+  round?: boolean
+  /** 深色 */
+  dark?: boolean
+}
+
+export interface TagEmits {
+  (e: 'close'): void
+}
+export interface TagExposed {}

package/src/types/text.ts

@@ -0,0 +1,28 @@
+/** 文本组件属性 */
+export interface TextProps {
+  /** 使用预设文本类型, 默认content正文 */
+  as?: 'main-title' | 'title' | 'sub-title' | 'content' | 'additional'
+  /** 文本大小, 与as同时指定时会覆盖as */
+  fontSize?: string | number
+  /** 是否删除 */
+  deleted?: boolean
+  /** 下划线 */
+  underline?: boolean
+  /** 粗体, 与as同时指定时会覆盖as中的字体粗细 */
+  bold?: boolean
+  /** 斜体 */
+  italic?: boolean
+  /** 高亮 */
+  highlight?: string | string[]
+}
+
+/** 文本组件定义的事件 */
+export interface TextEmits {
+  (e: 'update:modelValue', value: string): void
+}
+
+/** 文本组件暴露的属性和方法(组件内部使用) */
+export interface _TextExposed {}
+
+/** 文本组件暴露的属性和方法(组件外部使用) */
+export type TextExposed = {}

package/src/types/textarea.ts

@@ -0,0 +1,76 @@
+import type { DeconstructValue, FormComponentProps } from '@veltra/utils'
+
+/** 文本域组件属性（API 与 @veltra/desktop UTextarea 对齐；字号 16px、行高与内边距走移动端 token） */
+export interface TextareaProps extends FormComponentProps {
+  /**
+   * 文本域的值
+   */
+  modelValue?: string
+  /**
+   * 文本域的高度
+   */
+  height?: string
+  /**
+   * 文本域的占位符
+   */
+  placeholder?: string
+  /**
+   * 文本域是否禁用
+   */
+  disabled?: boolean
+  /**
+   * 文本域是否只读
+   */
+  readonly?: boolean
+
+  /**
+   * 是否能被缩放
+   */
+  resize?: boolean
+  /**
+   * 文本域的行数
+   */
+  rows?: number
+  /**
+   * 文本域的列数
+   */
+  cols?: number
+  /**
+   * 文本域的最大字数
+   */
+  maxlength?: number
+  /**
+   * 是否显示字符数统计（当前字数/最大字数，展示在文本域右下角）
+   */
+  showCount?: boolean
+  /**
+   * 清空
+   */
+  clearable?: boolean
+
+  /** 原生只读 */
+  nativeReadonly?: boolean
+
+  /** 是否自适应大小 */
+  autosize?: boolean
+}
+
+/** 文本域组件定义的事件 */
+export interface TextareaEmits {
+  /** modelValue值改变时触发 */
+  (e: 'update:modelValue', value: string): void
+  /** 当 modelValue 改变时，并且文本框失去焦点或用户按Enter时触发 */
+  (e: 'change', value: string): void
+  /** 文本框获取焦点时触发 */
+  (e: 'focus'): void
+  /** 文本框失去焦点时触发 */
+  (e: 'blur'): void
+  /** 清空按钮时触发 */
+  (e: 'clear'): void
+}
+
+/** 文本域暴露的属性和方法(组件内部使用) */
+export interface _TextareaExposed {}
+
+/** 文本域暴露的属性和方法(组件外部使用, 引用的值会被自动解构) */
+export type TextareaExposed = DeconstructValue<_TextareaExposed>

package/src/types/time-picker.ts

@@ -0,0 +1,40 @@
+import type { DeconstructValue, FormComponentProps } from '@veltra/utils'
+
+/** 绑定值类型 */
+export type TimePickerDataType = 'date' | 'timestamp' | 'string'
+
+/** time-picker组件属性（与 @veltra/desktop UTimePicker 对齐） */
+export interface TimePickerProps extends FormComponentProps {
+  modelValue?: string | number | Date
+  /** 占位 */
+  placeholder?: string
+  /** 时间格式化 */
+  format?: string
+  /** 时间值格式化, 当没有指定时默认使用format属性，仅当值和显示的内容不一致时才需要使用到该属性 */
+  valueFormat?: string
+  /**
+   * 绑定值的类型，默认为字符串。
+   * 当 dataType 没有指定为字符串时，valueFormat 属性不生效
+   */
+  dataType?: TimePickerDataType
+  /** 禁用的小时 */
+  disabledHours?: () => number[]
+  /** 禁用的分钟 */
+  disabledMinutes?: (hour: number) => number[]
+  /** 禁用的秒 */
+  disabledSeconds?: (hour: number, minute: number) => number[]
+  /** 是否显示清除按钮 */
+  clearable?: boolean
+}
+
+/** time-picker组件定义的事件 */
+export interface TimePickerEmits {
+  (e: 'update:modelValue', value?: string | number | Date): void
+  (e: 'change', time?: Date): void
+}
+
+/** time-picker组件暴露的属性和方法(组件内部使用) */
+export interface _TimePickerExposed {}
+
+/** time-picker组件暴露的属性和方法(组件外部使用, 引用的值会被自动解构) */
+export type TimePickerExposed = DeconstructValue<_TimePickerExposed>

package/src/types/timeline.ts

@@ -0,0 +1,15 @@
+/** 时间线节点圆点颜色语义 */
+export type TimelineItemColor = 'default' | 'primary' | 'success' | 'warning' | 'danger'
+
+/** 时间线容器组件属性 */
+export interface TimelineProps {}
+
+/** 时间线节点属性 */
+export interface TimelineItemProps {
+  /** 节点圆点颜色语义，默认 'default'（中性色圆点） */
+  color?: TimelineItemColor
+  /** 节点时间戳文本 */
+  timestamp?: string
+  /** 时间戳位置：top 内容上方 / bottom 内容下方，默认 'bottom' */
+  timestampPlacement?: 'top' | 'bottom'
+}

package/src/types/uploader.ts

@@ -0,0 +1,50 @@
+import type { FormComponentProps } from '@veltra/utils'
+
+/** 上传文件项（url 可为本地 blob 地址或已上传地址） */
+export interface UploaderFileItem {
+  /** 文件访问地址（本地预览为 blob: 地址；上传失败时为空） */
+  url: string
+  /** 文件名（用于类型识别与展示，回显历史数据时建议必传） */
+  name?: string
+  /** 文件大小（字节） */
+  size?: number
+  /** 上传状态：传入 upload 时未完成前为 uploading，失败为 failed */
+  status?: 'uploading' | 'done' | 'failed'
+}
+
+/** 上传组件属性（报销填报场景：图片 / word / excel / pdf） */
+export interface UploaderProps extends FormComponentProps {
+  /** 文件列表（v-model） */
+  modelValue?: UploaderFileItem[]
+  /** 接受的文件类型，透传原生 input accept */
+  accept?: string
+  /** 是否多选 */
+  multiple?: boolean
+  /** 最大文件数量，超出后隐藏上传入口 */
+  maxCount?: number
+  /** 单文件大小上限（字节），超出触发 oversize 并丢弃 */
+  maxSize?: number
+  /**
+   * 是否显示删除按钮；传函数可按文件控制（返回 false 隐藏该文件的删除按钮，如补传模式仅允许删补传附件）。
+   * 注意联合类型须函数成员在前，否则 defineProps 宏推导运行时类型时会丢失 Function
+   */
+  deletable?: ((file: UploaderFileItem, index: number) => boolean) | boolean
+  /** 点击图片是否打开内置大图预览；文档类型始终只派发 click-file */
+  preview?: boolean
+  /** 自定义上传，返回文件地址；不传则本地 blob 地址直显 */
+  upload?: (file: File) => Promise<string>
+  /** 读取文件前校验，返回 false（或 resolve false）阻止添加 */
+  beforeRead?: (file: File) => boolean | Promise<boolean>
+}
+
+/** 上传组件定义的事件 */
+export interface UploaderEmits {
+  (e: 'update:modelValue', files: UploaderFileItem[]): void
+  (e: 'change', files: UploaderFileItem[]): void
+  (e: 'oversize', files: File[]): void
+  (e: 'delete', file: UploaderFileItem, index: number): void
+  (e: 'click-file', file: UploaderFileItem, index: number): void
+}
+
+/** 上传组件暴露的对象 */
+export interface UploaderExposed {}

package/.turbo/turbo-build.log

@@ -1,2 +0,0 @@
-
-$ bun -e 'void 0'

package/.turbo/turbo-check-types.log

@@ -1 +0,0 @@
-$ tsc -p tsconfig.json --noEmit

package/tsconfig.json

@@ -1,12 +0,0 @@
-{
-  "extends": "@cat-kit/tsconfig/tsconfig.web.json",
-  "compilerOptions": {
-    "composite": true,
-    "declaration": true,
-    "rootDir": "./src",
-    "outDir": "./dist",
-    "skipDefaultLibCheck": true
-  },
-  "include": ["src/**/*.ts"],
-  "exclude": ["node_modules"]
-}