@h-ai/ui 0.1.0-alpha.67 → 0.1.0-alpha.68

package/dist/components/primitives/Input.svelte.d.ts

@@ -3,6 +3,16 @@ type $$ComponentProps = InputProps & DataAttributes;
 /**
  * Input
  * 文本输入框组件，支持自定义验证消息
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Input } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Input> = { name: 'email', type: 'email', required: true }
+ * const component = mount(Input, { target: document.body, props })
+ * await unmount(component)
+ * ```
  */
 declare const Input: import("svelte").Component<$$ComponentProps, {}, "value" | "inputRef">;
 type Input = ReturnType<typeof Input>;

package/dist/components/primitives/Progress.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Progress
   =============================================================================
   @h-ai/ui - Progress 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $derived)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Progress } from '@h-ai/ui'
+  const props: ComponentProps<typeof Progress> = { value: 65, max: 100, showLabel: true }
+  const component = mount(Progress, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, ProgressProps } from '../../types.js'

package/dist/components/primitives/Progress.svelte.d.ts

@@ -1,5 +1,25 @@
 import type { DataAttributes, ProgressProps } from '../../types.js';
 type $$ComponentProps = ProgressProps & DataAttributes;
+/**
+ * Progress
+ * =============================================================================
+ * @h-ai/ui - Progress 组件
+ * =============================================================================
+ * 进度条组件
+ *
+ * 使用 Svelte 5 Runes ($props, $derived)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Progress } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Progress> = { value: 65, max: 100, showLabel: true }
+ * const component = mount(Progress, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Progress: import("svelte").Component<$$ComponentProps, {}, "">;
 type Progress = ReturnType<typeof Progress>;
 export default Progress;

package/dist/components/primitives/Radio.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Radio
   =============================================================================
   @h-ai/ui - Radio 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $derived, $bindable)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Radio } from '@h-ai/ui'
+  const props: ComponentProps<typeof Radio> = { options: [{ value: 'email', label: '邮件' }], value: 'email' }
+  const component = mount(Radio, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts' generics="T = string">
   import type { DataAttributes, RadioProps, SelectOption } from '../../types.js'

package/dist/components/primitives/Radio.svelte.d.ts

@@ -20,6 +20,26 @@ interface $$IsomorphicComponent {
     <T = string>(internal: unknown, props: ReturnType<__sveltets_Render<T>['props']> & {}): ReturnType<__sveltets_Render<T>['exports']>;
     z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
 }
+/**
+ * Radio
+ * =============================================================================
+ * @h-ai/ui - Radio 组件
+ * =============================================================================
+ * 单选框组件，支持组模式
+ *
+ * 使用 Svelte 5 Runes ($props, $derived, $bindable)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Radio } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Radio> = { options: [{ value: 'email', label: '邮件' }], value: 'email' }
+ * const component = mount(Radio, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Radio: $$IsomorphicComponent;
 type Radio<T = string> = InstanceType<typeof Radio<T>>;
 export default Radio;

package/dist/components/primitives/Range.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Range
   =============================================================================
   @h-ai/ui - Range 组件
   =============================================================================
@@ -7,12 +8,35 @@
   使用 Svelte 5 Runes ($props, $derived)
   使用 DaisyUI range 类
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Range } from '@h-ai/ui'
+  const props: ComponentProps<typeof Range> = { value: 50, min: 0, max: 100, step: 5 }
+  const component = mount(Range, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes } from '../../types.js'
   import { cn, getDataAttributes } from '../../utils.js'
   import BareInput from './BareInput.svelte'
 
+  /**
+   * Range 组件的属性契约；通过公开组件配置使用。
+   *
+   * @example
+   * ```ts
+   * import { mount, unmount } from 'svelte'
+   * import type { ComponentProps } from 'svelte'
+   * import { Range } from '@h-ai/ui'
+   * const props: ComponentProps<typeof Range> = { value: 50, min: 0, max: 100, step: 5 }
+   * const component = mount(Range, { target: document.body, props })
+   * await unmount(component)
+   * ```
+   */
   interface Props {
     /** 当前值 */
     value?: number

package/dist/components/primitives/Range.svelte.d.ts

@@ -1,4 +1,17 @@
 import type { DataAttributes } from '../../types.js';
+/**
+ * Range 组件的属性契约；通过公开组件配置使用。
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Range } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Range> = { value: 50, min: 0, max: 100, step: 5 }
+ * const component = mount(Range, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 interface Props {
     /** 当前值 */
     value?: number;
@@ -24,6 +37,27 @@ interface Props {
     class?: string;
 }
 type $$ComponentProps = Props & DataAttributes;
+/**
+ * Range
+ * =============================================================================
+ * @h-ai/ui - Range 组件
+ * =============================================================================
+ * 范围滑块组件，支持不同尺寸和颜色变体
+ *
+ * 使用 Svelte 5 Runes ($props, $derived)
+ * 使用 DaisyUI range 类
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Range } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Range> = { value: 50, min: 0, max: 100, step: 5 }
+ * const component = mount(Range, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Range: import("svelte").Component<$$ComponentProps, {}, "value">;
 type Range = ReturnType<typeof Range>;
 export default Range;

package/dist/components/primitives/Rating.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Rating
   =============================================================================
   @h-ai/ui - Rating 组件
   =============================================================================
@@ -7,12 +8,35 @@
   使用 Svelte 5 Runes ($props, $state, $derived)
   使用 DaisyUI rating 类
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Rating } from '@h-ai/ui'
+  const props: ComponentProps<typeof Rating> = { value: 4, max: 5, readonly: true }
+  const component = mount(Rating, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes } from '../../types.js'
   import { uiM } from '../../messages.js'
   import { cn, getDataAttributes } from '../../utils.js'
 
+  /**
+   * Rating 组件的属性契约；通过公开组件配置使用。
+   *
+   * @example
+   * ```ts
+   * import { mount, unmount } from 'svelte'
+   * import type { ComponentProps } from 'svelte'
+   * import { Rating } from '@h-ai/ui'
+   * const props: ComponentProps<typeof Rating> = { value: 4, max: 5, readonly: true }
+   * const component = mount(Rating, { target: document.body, props })
+   * await unmount(component)
+   * ```
+   */
   interface Props {
     /** 当前评分值 (0 - max) */
     value?: number

package/dist/components/primitives/Rating.svelte.d.ts

@@ -1,4 +1,17 @@
 import type { DataAttributes } from '../../types.js';
+/**
+ * Rating 组件的属性契约；通过公开组件配置使用。
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Rating } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Rating> = { value: 4, max: 5, readonly: true }
+ * const component = mount(Rating, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 interface Props {
     /** 当前评分值 (0 - max) */
     value?: number;
@@ -24,6 +37,27 @@ interface Props {
     class?: string;
 }
 type $$ComponentProps = Props & DataAttributes;
+/**
+ * Rating
+ * =============================================================================
+ * @h-ai/ui - Rating 组件
+ * =============================================================================
+ * 星级评分组件，支持全星/半星、只读模式、不同尺寸和颜色
+ *
+ * 使用 Svelte 5 Runes ($props, $state, $derived)
+ * 使用 DaisyUI rating 类
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Rating } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Rating> = { value: 4, max: 5, readonly: true }
+ * const component = mount(Rating, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Rating: import("svelte").Component<$$ComponentProps, {}, "value">;
 type Rating = ReturnType<typeof Rating>;
 export default Rating;

package/dist/components/primitives/Select.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Select
   =============================================================================
   @h-ai/ui - Select 组件
   =============================================================================
@@ -7,6 +8,16 @@
   使用 Svelte 5 Runes ($props, $derived, $bindable)
   支持 clearable（可清空）和 filterable（可筛选）属性
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Select } from '@h-ai/ui'
+  const props: ComponentProps<typeof Select> = { options: [{ value: 'active', label: '启用' }], value: 'active' }
+  const component = mount(Select, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts' generics="T = string">
   import type { DataAttributes, SelectProps } from '../../types.js'

package/dist/components/primitives/Select.svelte.d.ts

@@ -20,6 +20,27 @@ interface $$IsomorphicComponent {
     <T = string>(internal: unknown, props: ReturnType<__sveltets_Render<T>['props']> & {}): ReturnType<__sveltets_Render<T>['exports']>;
     z_$$bindings?: ReturnType<__sveltets_Render<any>['bindings']>;
 }
+/**
+ * Select
+ * =============================================================================
+ * @h-ai/ui - Select 组件
+ * =============================================================================
+ * 下拉选择框组件（全自定义实现，统一弹出层样式）
+ *
+ * 使用 Svelte 5 Runes ($props, $derived, $bindable)
+ * 支持 clearable（可清空）和 filterable（可筛选）属性
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Select } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Select> = { options: [{ value: 'active', label: '启用' }], value: 'active' }
+ * const component = mount(Select, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Select: $$IsomorphicComponent;
 type Select<T = string> = InstanceType<typeof Select<T>>;
 export default Select;

package/dist/components/primitives/Spinner.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Spinner
   =============================================================================
   @h-ai/ui - Spinner 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $derived)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Spinner } from '@h-ai/ui'
+  const props: ComponentProps<typeof Spinner> = { size: 'sm', variant: 'primary' }
+  const component = mount(Spinner, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, SpinnerProps } from '../../types.js'

package/dist/components/primitives/Spinner.svelte.d.ts

@@ -1,5 +1,25 @@
 import type { DataAttributes, SpinnerProps } from '../../types.js';
 type $$ComponentProps = SpinnerProps & DataAttributes;
+/**
+ * Spinner
+ * =============================================================================
+ * @h-ai/ui - Spinner 组件
+ * =============================================================================
+ * 加载指示器组件
+ *
+ * 使用 Svelte 5 Runes ($props, $derived)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Spinner } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Spinner> = { size: 'sm', variant: 'primary' }
+ * const component = mount(Spinner, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Spinner: import("svelte").Component<$$ComponentProps, {}, "">;
 type Spinner = ReturnType<typeof Spinner>;
 export default Spinner;

package/dist/components/primitives/Switch.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Switch
   =============================================================================
   @h-ai/ui - Switch 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $derived, $bindable)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Switch } from '@h-ai/ui'
+  const props: ComponentProps<typeof Switch> = { label: '开启通知', checked: true }
+  const component = mount(Switch, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, SwitchProps } from '../../types.js'

package/dist/components/primitives/Switch.svelte.d.ts

@@ -1,5 +1,25 @@
 import type { DataAttributes, SwitchProps } from '../../types.js';
 type $$ComponentProps = SwitchProps & DataAttributes;
+/**
+ * Switch
+ * =============================================================================
+ * @h-ai/ui - Switch 组件
+ * =============================================================================
+ * 开关组件
+ *
+ * 使用 Svelte 5 Runes ($props, $derived, $bindable)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Switch } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Switch> = { label: '开启通知', checked: true }
+ * const component = mount(Switch, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Switch: import("svelte").Component<$$ComponentProps, {}, "checked">;
 type Switch = ReturnType<typeof Switch>;
 export default Switch;

package/dist/components/primitives/Tag.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Tag
   =============================================================================
   @h-ai/ui - Tag 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $derived)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Tag } from '@h-ai/ui'
+  const props: ComponentProps<typeof Tag> = { text: '已启用', variant: 'success', closable: true }
+  const component = mount(Tag, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, TagProps } from '../../types.js'

package/dist/components/primitives/Tag.svelte.d.ts

@@ -1,5 +1,25 @@
 import type { DataAttributes, TagProps } from '../../types.js';
 type $$ComponentProps = TagProps & DataAttributes;
+/**
+ * Tag
+ * =============================================================================
+ * @h-ai/ui - Tag 组件
+ * =============================================================================
+ * 标签组件
+ *
+ * 使用 Svelte 5 Runes ($props, $derived)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Tag } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Tag> = { text: '已启用', variant: 'success', closable: true }
+ * const component = mount(Tag, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Tag: import("svelte").Component<$$ComponentProps, {}, "">;
 type Tag = ReturnType<typeof Tag>;
 export default Tag;

package/dist/components/primitives/Textarea.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component Textarea
   =============================================================================
   @h-ai/ui - Textarea 组件
   =============================================================================
@@ -7,6 +8,16 @@
   使用 Svelte 5 Runes ($props, $derived, $bindable)
   支持自定义验证消息（validationMessage）覆盖浏览器原生提示
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { Textarea } from '@h-ai/ui'
+  const props: ComponentProps<typeof Textarea> = { name: 'description', rows: 4, maxlength: 500 }
+  const component = mount(Textarea, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, TextareaProps } from '../../types.js'

package/dist/components/primitives/Textarea.svelte.d.ts

@@ -1,5 +1,26 @@
 import type { DataAttributes, TextareaProps } from '../../types.js';
 type $$ComponentProps = TextareaProps & DataAttributes;
+/**
+ * Textarea
+ * =============================================================================
+ * @h-ai/ui - Textarea 组件
+ * =============================================================================
+ * 多行文本输入框组件
+ *
+ * 使用 Svelte 5 Runes ($props, $derived, $bindable)
+ * 支持自定义验证消息（validationMessage）覆盖浏览器原生提示
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { Textarea } from '@h-ai/ui'
+ * const props: ComponentProps<typeof Textarea> = { name: 'description', rows: 4, maxlength: 500 }
+ * const component = mount(Textarea, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const Textarea: import("svelte").Component<$$ComponentProps, {}, "value" | "textareaRef">;
 type Textarea = ReturnType<typeof Textarea>;
 export default Textarea;

package/dist/components/primitives/ToggleCheckbox.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component ToggleCheckbox
   =============================================================================
   @h-ai/ui - ToggleCheckbox 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $bindable)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { ToggleCheckbox } from '@h-ai/ui'
+  const props: ComponentProps<typeof ToggleCheckbox> = { name: 'expanded', checked: true }
+  const component = mount(ToggleCheckbox, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, ToggleCheckboxProps } from '../../types.js'

package/dist/components/primitives/ToggleCheckbox.svelte.d.ts

@@ -1,5 +1,25 @@
 import type { DataAttributes, ToggleCheckboxProps } from '../../types.js';
 type $$ComponentProps = ToggleCheckboxProps & DataAttributes;
+/**
+ * ToggleCheckbox
+ * =============================================================================
+ * @h-ai/ui - ToggleCheckbox 组件
+ * =============================================================================
+ * 仅渲染 checkbox input（用于 collapse/drawer 等结构要求）
+ *
+ * 使用 Svelte 5 Runes ($props, $bindable)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { ToggleCheckbox } from '@h-ai/ui'
+ * const props: ComponentProps<typeof ToggleCheckbox> = { name: 'expanded', checked: true }
+ * const component = mount(ToggleCheckbox, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const ToggleCheckbox: import("svelte").Component<$$ComponentProps, {}, "checked">;
 type ToggleCheckbox = ReturnType<typeof ToggleCheckbox>;
 export default ToggleCheckbox;

package/dist/components/primitives/ToggleInput.svelte

@@ -1,4 +1,5 @@
 <!--
+  @component ToggleInput
   =============================================================================
   @h-ai/ui - ToggleInput 组件
   =============================================================================
@@ -6,6 +7,16 @@
 
   使用 Svelte 5 Runes ($props, $bindable)
   =============================================================================
+
+  @example
+  ```ts
+  import { mount, unmount } from 'svelte'
+  import type { ComponentProps } from 'svelte'
+  import { ToggleInput } from '@h-ai/ui'
+  const props: ComponentProps<typeof ToggleInput> = { name: 'expanded', checked: true }
+  const component = mount(ToggleInput, { target: document.body, props })
+  await unmount(component)
+  ```
 -->
 <script lang='ts'>
   import type { DataAttributes, ToggleCheckboxProps } from '../../types.js'

package/dist/components/primitives/ToggleInput.svelte.d.ts

@@ -1,5 +1,25 @@
 import type { DataAttributes, ToggleCheckboxProps } from '../../types.js';
 type $$ComponentProps = ToggleCheckboxProps & DataAttributes;
+/**
+ * ToggleInput
+ * =============================================================================
+ * @h-ai/ui - ToggleInput 组件
+ * =============================================================================
+ * 仅渲染原生 checkbox/radio input，用于需要 input 作为直接子元素的场景
+ *
+ * 使用 Svelte 5 Runes ($props, $bindable)
+ * =============================================================================
+ *
+ * @example
+ * ```ts
+ * import { mount, unmount } from 'svelte'
+ * import type { ComponentProps } from 'svelte'
+ * import { ToggleInput } from '@h-ai/ui'
+ * const props: ComponentProps<typeof ToggleInput> = { name: 'expanded', checked: true }
+ * const component = mount(ToggleInput, { target: document.body, props })
+ * await unmount(component)
+ * ```
+ */
 declare const ToggleInput: import("svelte").Component<$$ComponentProps, {}, "checked">;
 type ToggleInput = ReturnType<typeof ToggleInput>;
 export default ToggleInput;