@moubing/bing-ui 0.5.3 → 0.6.0

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

@@ -4,11 +4,11 @@ type __VLS_Slots = {
     default?: (props: BingAppSwitcherTransitionSlotProps) => unknown;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingAppSwitcherTransitionProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: BingTabValue) => any;
     change: (payload: import('./BingAppSwitcherTransition.types').BingAppSwitcherTransitionChangePayload) => any;
+    "update:modelValue": (value: BingTabValue) => any;
 }, string, import('vue').PublicProps, Readonly<BingAppSwitcherTransitionProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: BingTabValue) => any) | undefined;
     onChange?: ((payload: import('./BingAppSwitcherTransition.types').BingAppSwitcherTransitionChangePayload) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: BingTabValue) => any) | undefined;
 }>, {
     disabled: boolean;
     respectReducedMotion: boolean;

package/dist/components/BingButton/BingButton.types.d.ts

@@ -14,6 +14,7 @@ export interface BingButtonProps {
     disabled?: boolean;
     loading?: boolean;
     block?: boolean;
+    /** 是否启用点击节流，默认关闭。开启后使用 throttleDelay 指定间隔。 */
     throttle?: boolean;
     throttleDelay?: number;
     textEffect?: BingButtonTextEffect;

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

@@ -8,14 +8,14 @@ type __VLS_Slots = {} & {
     suffix?: (props: typeof __VLS_11) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingButtonProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    focus: (event: FocusEvent) => any;
     blur: (event: FocusEvent) => any;
     click: (event: MouseEvent) => any;
+    focus: (event: FocusEvent) => any;
     throttled: (payload: import('./BingButton.types').BingButtonThrottledPayload) => any;
 }, string, import('vue').PublicProps, Readonly<BingButtonProps> & Readonly<{
-    onFocus?: ((event: FocusEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
     onClick?: ((event: MouseEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
     onThrottled?: ((payload: import('./BingButton.types').BingButtonThrottledPayload) => any) | undefined;
 }>, {
     disabled: boolean;

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

@@ -4,11 +4,11 @@ type __VLS_Slots = {
     default?: (props: BingCarouselTransitionSlotProps) => unknown;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingCarouselTransitionProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: BingTabValue) => any;
     change: (payload: import('./BingCarouselTransition.types').BingCarouselTransitionChangePayload) => any;
+    "update:modelValue": (value: BingTabValue) => any;
 }, string, import('vue').PublicProps, Readonly<BingCarouselTransitionProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: BingTabValue) => any) | undefined;
     onChange?: ((payload: import('./BingCarouselTransition.types').BingCarouselTransitionChangePayload) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: BingTabValue) => any) | undefined;
 }>, {
     disabled: boolean;
     respectReducedMotion: boolean;

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

@@ -4,26 +4,26 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_13) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingCheckboxProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: boolean) => any;
     change: (value: boolean, event: Event) => any;
-    focus: (event: FocusEvent) => any;
     blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
+    "update:modelValue": (value: boolean) => any;
 }, string, import('vue').PublicProps, Readonly<BingCheckboxProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onChange?: ((value: boolean, event: Event) => any) | undefined;
-    onFocus?: ((event: FocusEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
 }>, {
     disabled: boolean;
     label: string;
-    value: string | number;
+    id: string;
     ariaLabel: string;
+    name: string;
+    value: string | number;
     modelValue: boolean;
     size: import('./BingCheckbox.types').BingCheckboxSize;
-    name: string;
     tone: import('./BingCheckbox.types').BingCheckboxTone;
     decorative: boolean;
-    id: string;
     indeterminate: boolean;
     shape: import('./BingCheckbox.types').BingCheckboxShape;
     ariaDescribedby: string;

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

@@ -4,23 +4,23 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingCheckboxGroupProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: BingCheckboxGroupValue[]) => any;
     change: (value: BingCheckboxGroupValue[], event: Event) => any;
-    focus: (event: FocusEvent) => any;
     blur: (event: FocusEvent) => any;
+    focus: (event: FocusEvent) => any;
+    "update:modelValue": (value: BingCheckboxGroupValue[]) => any;
 }, string, import('vue').PublicProps, Readonly<BingCheckboxGroupProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: BingCheckboxGroupValue[]) => any) | undefined;
     onChange?: ((value: BingCheckboxGroupValue[], event: Event) => any) | undefined;
-    onFocus?: ((event: FocusEvent) => any) | undefined;
     onBlur?: ((event: FocusEvent) => any) | undefined;
+    onFocus?: ((event: FocusEvent) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: BingCheckboxGroupValue[]) => any) | undefined;
 }>, {
     disabled: boolean;
     direction: import('./BingCheckboxGroup.types').BingCheckboxGroupDirection;
+    id: string;
     ariaLabel: string;
+    name: string;
     modelValue: BingCheckboxGroupValue[];
     size: import('./BingCheckboxGroup.types').BingCheckboxGroupSize;
-    name: string;
-    id: string;
     ariaDescribedby: string;
     status: "default" | "error" | "success" | "warning";
     options: BingCheckboxGroupOption[];

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

@@ -2,32 +2,32 @@ import { BingColorPickerChangePayload, BingColorPickerExpose, BingColorPickerPre
 declare const _default: typeof __VLS_export;
 export default _default;
 declare const __VLS_export: import('vue').DefineComponent<BingColorPickerProps, BingColorPickerExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: string) => any;
     change: (payload: BingColorPickerChangePayload) => any;
     close: () => any;
     copy: (payload: import('./BingColorPicker.types').BingColorPickerCopyPayload) => any;
+    "update:modelValue": (value: string) => any;
     copyError: (error: Error) => any;
     open: () => any;
 }, string, import('vue').PublicProps, Readonly<BingColorPickerProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
     onChange?: ((payload: BingColorPickerChangePayload) => any) | undefined;
     onClose?: (() => any) | undefined;
     onCopy?: ((payload: import('./BingColorPicker.types').BingColorPickerCopyPayload) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string) => any) | undefined;
     onCopyError?: ((error: Error) => any) | undefined;
     onOpen?: (() => any) | undefined;
 }>, {
     disabled: boolean;
     minWidth: string | number;
     width: string | number;
-    glass: boolean;
+    id: string;
     ariaLabel: string;
+    glass: boolean;
     modelValue: import('./BingColorPicker.types').BingColorPickerModelValue;
     size: import('./BingColorPicker.types').BingColorPickerSize;
     block: boolean;
     glassBlur: string | number;
     glassOpacity: number;
     glassSaturation: number;
-    id: string;
     ariaDescribedby: string;
     status: "default" | "error" | "success" | "warning";
     copyLabel: string;

package/dist/components/BingCursor/BingCursor.controller.d.ts

@@ -0,0 +1,13 @@
+import { BingCursorProps, BingCursorSlotProps } from './BingCursor.types';
+interface CursorOwner {
+    root: HTMLElement;
+    options: () => BingCursorProps;
+    show: (state: Omit<BingCursorSlotProps, 'size'>, x: number, y: number) => boolean;
+    move: (x: number, y: number) => void;
+    hide: () => void;
+}
+export declare function registerCursor(owner: CursorOwner): {
+    refresh: () => void;
+    destroy(): void;
+};
+export {};

package/dist/components/BingCursor/BingCursor.morph.d.ts

@@ -0,0 +1,9 @@
+import { BingCursorType } from './BingCursor.types';
+/** 把点击热点统一对齐到画布中心，轮廓形变不带动鼠标位置。 */
+export declare function alignCursorPaths(type: BingCursorType, hotspot: readonly [number, number], size: number): {
+    d: string;
+    ink: number;
+    outline: number;
+    strokeWidth: number;
+    opacity: number;
+}[];

package/dist/components/BingCursor/BingCursor.presets.d.ts

@@ -0,0 +1,5 @@
+import { BingCursorType } from './BingCursor.types';
+export declare const cursorHotspots: Record<BingCursorType, readonly [number, number]>;
+export declare function isCursorType(value: string): value is BingCursorType;
+/** null 表示保留原生光标（例如 busy、外部图片、自定义原生控件）。 */
+export declare function resolveCursorType(target: Element, cssCursor: string, requested?: BingCursorType | 'auto', pressed?: boolean): BingCursorType | null;

package/dist/components/BingCursor/BingCursor.shapes.d.ts

@@ -0,0 +1,11 @@
+import { BingCursorType } from './BingCursor.types';
+export interface CursorPath {
+    d: string;
+    /** 1 为主色，0 为描边色；形变时同步插值这两个颜色。 */
+    ink: number;
+    outline: number;
+    strokeWidth: number;
+    opacity: number;
+}
+/** 预览与鼠标共用相同的四层路径：主体轮廓和三个细节，始终保持节点身份。 */
+export declare const cursorShapes: Record<BingCursorType, readonly CursorPath[]>;

package/dist/components/BingCursor/BingCursor.styleSource.d.ts

@@ -0,0 +1,5 @@
+/** 将原 cursor 声明映射到私有变量，让浏览器继续处理选择器、优先级和继承。 */
+export declare function createCursorStyleSource(doc: Document): {
+    read(target: Element): string;
+    destroy(): void;
+};

package/dist/components/BingCursor/BingCursor.types.d.ts

@@ -0,0 +1,39 @@
+import { VNode } from 'vue';
+export type BingCursorType = 'default' | 'pointer' | 'not-allowed' | 'text' | 'grab' | 'grabbing' | 'move' | 'crosshair' | 'col-resize' | 'row-resize' | 'ew-resize' | 'ns-resize' | 'nwse-resize' | 'nesw-resize' | 'zoom-in' | 'zoom-out';
+export type BingCursorMode = 'replace' | 'follow';
+export interface BingCursorProps {
+    /** 自动识别元素的 CSS cursor 和交互语义，也可固定一种光标。 */
+    type?: BingCursorType | 'auto';
+    /** replace 使用自定义光标；follow 保留原生光标并显示跟随圆环。 */
+    mode?: BingCursorMode;
+    /** 默认只作用于默认插槽的内容；开启后作用于当前文档。 */
+    global?: boolean;
+    disabled?: boolean;
+    /** 光标画布大小，单位 px。 */
+    size?: number;
+    color?: string;
+    outlineColor?: string;
+    /** 自定义插槽的点击热点，相对于插槽左上角，单位 px。 */
+    hotspot?: readonly [number, number];
+    /** 仅跟随模式使用，单位秒；替换模式始终精确定位。 */
+    followDuration?: number;
+    /** 内置 SVG 轮廓形变与自定义提示的过渡时长，单位秒，默认 0.24；设为 0 关闭。 */
+    transitionDuration?: number;
+    zIndex?: number;
+}
+export interface BingCursorSlotProps {
+    type: BingCursorType;
+    pressed: boolean;
+    size: number;
+    /** 来自当前元素或祖先的 data-bing-cursor-label。 */
+    label: string;
+    target: Element | null;
+}
+export interface BingCursorSlots {
+    default?: () => VNode[];
+    cursor?: (props: BingCursorSlotProps) => VNode[];
+}
+export interface BingCursorEmits {
+    change: [type: BingCursorType];
+    'visibility-change': [visible: boolean];
+}

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

@@ -0,0 +1,26 @@
+import { BingCursorProps, BingCursorSlots, BingCursorType } from './BingCursor.types';
+type __VLS_Slots = BingCursorSlots;
+declare const __VLS_base: import('vue').DefineComponent<BingCursorProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (type: BingCursorType) => any;
+    "visibility-change": (visible: boolean) => any;
+}, string, import('vue').PublicProps, Readonly<BingCursorProps> & Readonly<{
+    onChange?: ((type: BingCursorType) => any) | undefined;
+    "onVisibility-change"?: ((visible: boolean) => any) | undefined;
+}>, {
+    disabled: boolean;
+    transitionDuration: number;
+    zIndex: number;
+    type: BingCursorType | "auto";
+    mode: import('./BingCursor.types').BingCursorMode;
+    size: number;
+    global: boolean;
+    followDuration: number;
+}, {}, {}, {}, 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/BingCursor/BingCursorMorph.vue.d.ts

@@ -0,0 +1,11 @@
+import { BingCursorType } from './BingCursor.types';
+type __VLS_Props = {
+    type: BingCursorType;
+    size: number;
+    hotspot: readonly [number, number];
+    duration: number;
+    active: boolean;
+};
+declare const __VLS_export: import('vue').DefineComponent<__VLS_Props, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {}, string, import('vue').PublicProps, Readonly<__VLS_Props> & Readonly<{}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+declare const _default: typeof __VLS_export;
+export default _default;

package/dist/components/BingCursor/BingCursorTransition.vue.d.ts

@@ -0,0 +1,28 @@
+import { BingCursorMode, BingCursorSlotProps } from './BingCursor.types';
+type __VLS_Props = {
+    state: BingCursorSlotProps;
+    hotspot: readonly [number, number];
+    duration: number;
+    active: boolean;
+    mode: BingCursorMode;
+    custom: boolean;
+};
+declare var __VLS_1: {
+    type: import('./BingCursor.types').BingCursorType;
+    pressed: boolean;
+    size: number;
+    label: string;
+    target: Element | null;
+};
+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<{}>, {}, {}, {}, {}, 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/BingCursor/index.d.ts

@@ -0,0 +1,2 @@
+export { default as BingCursor } from './BingCursor.vue';
+export type { BingCursorEmits, BingCursorMode, BingCursorProps, BingCursorSlotProps, BingCursorSlots, BingCursorType, } from './BingCursor.types';

package/dist/components/BingDatePicker/BingDatePicker.types.d.ts

@@ -38,6 +38,7 @@ export interface BingDatePickerProps extends BingGlassEffectProps {
     minWidth?: string | number;
     format?: string;
     valueFormat?: string;
+    /** 日历月份、星期的格式化语言，默认 zh-CN。 */
     locale?: string;
     firstDayOfWeek?: number;
     min?: string;

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

@@ -2,26 +2,27 @@ import { Dayjs } from 'dayjs';
 import { BingDatePickerChangePayload, BingDatePickerExpose, BingDatePickerModelValue, BingDatePickerProps, BingDatePickerType } from './BingDatePicker.types';
 declare const __VLS_export: import('vue').DefineComponent<BingDatePickerProps, BingDatePickerExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
     clear: () => any;
-    "update:modelValue": (value: BingDatePickerModelValue) => any;
     change: (payload: BingDatePickerChangePayload) => any;
     cancel: () => any;
     close: () => any;
+    "update:modelValue": (value: BingDatePickerModelValue) => any;
     open: () => any;
     confirm: (payload: BingDatePickerChangePayload) => any;
 }, string, import('vue').PublicProps, Readonly<BingDatePickerProps> & Readonly<{
     onClear?: (() => any) | undefined;
-    "onUpdate:modelValue"?: ((value: BingDatePickerModelValue) => any) | undefined;
     onChange?: ((payload: BingDatePickerChangePayload) => any) | undefined;
     onCancel?: (() => any) | undefined;
     onClose?: (() => any) | undefined;
+    "onUpdate:modelValue"?: ((value: BingDatePickerModelValue) => any) | undefined;
     onOpen?: (() => any) | undefined;
     onConfirm?: ((payload: BingDatePickerChangePayload) => any) | undefined;
 }>, {
     disabled: boolean;
     minWidth: string | number;
+    id: string;
     type: BingDatePickerType;
-    glass: boolean;
     ariaLabel: string;
+    glass: boolean;
     modelValue: BingDatePickerModelValue;
     size: import('./BingDatePicker.types').BingDatePickerSize;
     block: boolean;
@@ -29,7 +30,6 @@ declare const __VLS_export: import('vue').DefineComponent<BingDatePickerProps, B
     glassBlur: string | number;
     glassOpacity: number;
     glassSaturation: number;
-    id: string;
     ariaDescribedby: string;
     status: "default" | "error" | "success" | "warning";
     range: boolean;

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

@@ -5,11 +5,11 @@ type __VLS_Slots = {
     controls?: (props: BingDeckTransitionControlsSlotProps) => unknown;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingDeckTransitionProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: BingTabValue) => any;
     change: (payload: import('./BingDeckTransition.types').BingDeckTransitionChangePayload) => any;
+    "update:modelValue": (value: BingTabValue) => any;
 }, string, import('vue').PublicProps, Readonly<BingDeckTransitionProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: BingTabValue) => any) | undefined;
     onChange?: ((payload: import('./BingDeckTransition.types').BingDeckTransitionChangePayload) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: BingTabValue) => any) | undefined;
 }>, {
     disabled: boolean;
     respectReducedMotion: boolean;

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

@@ -15,21 +15,21 @@ type __VLS_Slots = {} & {
     footer?: (props: typeof __VLS_38) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingDialogProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: boolean) => any;
     cancel: () => any;
     close: (reason: BingDialogCloseReason) => any;
+    "update:modelValue": (value: boolean) => any;
     confirm: () => any;
 }, string, import('vue').PublicProps, Readonly<BingDialogProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onCancel?: (() => any) | undefined;
     onClose?: ((reason: BingDialogCloseReason) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onConfirm?: (() => any) | undefined;
 }>, {
     width: string | number;
     zIndex: number;
     title: string;
-    glass: boolean;
     ariaLabel: string;
+    glass: boolean;
     modelValue: boolean;
     smoothScroll: import('../..').SmoothScrollValue;
     glassBlur: string | number;

package/dist/components/BingDropDown/BingDropDown.context.d.ts

@@ -3,5 +3,6 @@ export interface BingDropDownContext {
     close: () => void;
     floatingId: string;
     getGlassStyle: () => Record<string, string>;
+    onMenuKeydown: (event: KeyboardEvent) => void;
 }
 export declare const bingDropDownContextKey: InjectionKey<BingDropDownContext>;

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

@@ -19,17 +19,17 @@ declare const __VLS_export: __VLS_WithSlots<import('vue').DefineComponent<BingDr
     "onAfter-leave"?: (() => any) | undefined;
 }>, {
     trigger: import('./BingDropDown.types').BingDropDownTrigger;
-    glass: boolean;
     ariaLabel: string;
+    glass: boolean;
     size: import('./BingDropDown.types').BingDropDownSize;
     block: boolean;
     loop: boolean;
     glassBlur: string | number;
     glassOpacity: number;
     glassSaturation: number;
+    open: boolean | null;
     placement: BingDropDownPlacement;
     closeOnOutside: boolean;
-    open: boolean | null;
     panelClass: string;
     closeOnEscape: boolean;
     autoFocus: boolean;

package/dist/components/BingDropDown/BingDropDownItem.vue.d.ts

@@ -9,10 +9,10 @@ declare const __VLS_export: __VLS_WithSlots<import('vue').DefineComponent<BingDr
     disabled: boolean;
     title: string;
     ariaLabel: string;
+    target: string;
     description: string;
     icon: import('vue').Component;
     tone: import('./BingDropDown.types').BingDropDownItemTone;
-    target: string;
     href: string;
     active: boolean;
     shortcut: string | string[];

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

@@ -1,14 +1,14 @@
 import { BingFilePreviewCloseReason, BingFilePreviewFile, BingFilePreviewProps } from './BingFilePreview.types';
 declare const __VLS_export: import('vue').DefineComponent<BingFilePreviewProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    "update:modelValue": (value: boolean) => any;
-    error: (error: Error) => any;
     close: (reason: BingFilePreviewCloseReason) => any;
+    error: (error: Error) => any;
+    "update:modelValue": (value: boolean) => any;
     download: (payload: import('./BingFilePreview.types').BingFilePreviewDownloadPayload) => any;
     openExternal: (payload: import('./BingFilePreview.types').BingFilePreviewOpenExternalPayload) => any;
 }, string, import('vue').PublicProps, Readonly<BingFilePreviewProps> & Readonly<{
-    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
-    onError?: ((error: Error) => any) | undefined;
     onClose?: ((reason: BingFilePreviewCloseReason) => any) | undefined;
+    onError?: ((error: Error) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: boolean) => any) | undefined;
     onDownload?: ((payload: import('./BingFilePreview.types').BingFilePreviewDownloadPayload) => any) | undefined;
     onOpenExternal?: ((payload: import('./BingFilePreview.types').BingFilePreviewOpenExternalPayload) => any) | undefined;
 }>, {
@@ -17,12 +17,12 @@ declare const __VLS_export: import('vue').DefineComponent<BingFilePreviewProps,
     width: string | number;
     zIndex: number;
     type: import('./BingFilePreview.types').BingFilePreviewKind;
-    glass: boolean;
     ariaLabel: string;
+    name: string;
+    glass: boolean;
     modelValue: boolean;
     size: number;
     smoothScroll: import('../..').SmoothScrollValue;
-    name: string;
     glassBlur: string | number;
     glassOpacity: number;
     glassSaturation: number;

package/dist/components/BingForm/BingForm.context.d.ts

@@ -3,6 +3,16 @@ import { BingControlStatus, BingFormBreakpoint, BingFormErrors, BingFormLabelPos
 export interface BingFormFieldRegistration {
     prop: string;
     scrollToField: () => void;
+    element: () => HTMLElement | null;
+    target: () => HTMLElement | null;
+}
+export interface BingFormNextHintField {
+    element: () => HTMLElement | null;
+    target: () => HTMLElement | null;
+    label: () => string;
+}
+export interface BingFormNextHintContext {
+    register: (field: BingFormNextHintField) => () => void;
 }
 export interface BingFormContext {
     size: ComputedRef<BingFormSize>;
@@ -15,6 +25,7 @@ export interface BingFormContext {
     getFieldErrors: (prop: string) => string[];
     registerField: (field: BingFormFieldRegistration) => void;
     unregisterField: (field: BingFormFieldRegistration) => void;
+    nextHint?: BingFormNextHintContext;
 }
 export interface BingFormItemContext {
     controlId: ComputedRef<string>;
@@ -25,7 +36,13 @@ export interface BingFormItemContext {
     disabled: ComputedRef<boolean>;
     handleControlChange: () => void;
     handleControlBlur: () => void;
+    labelId?: ComputedRef<string | undefined>;
+    nextControlId?: (fallbackId: string) => string;
+    registerControl?: (control: {
+        id: ComputedRef<string>;
+        group: boolean;
+    }) => () => void;
 }
-export declare const bingFormContextKey: InjectionKey<BingFormContext>;
-export declare const bingFormItemContextKey: InjectionKey<BingFormItemContext>;
+export declare const bingFormContextKey: InjectionKey<BingFormContext | null>;
+export declare const bingFormItemContextKey: InjectionKey<BingFormItemContext | null>;
 export declare function cloneErrors(errors: BingFormErrors): BingFormErrors;

package/dist/components/BingForm/BingForm.types.d.ts

@@ -3,7 +3,7 @@ export type BingControlStatus = 'default' | 'error' | 'success' | 'warning';
 export type BingFormSize = 'sm' | 'md' | 'lg';
 export type BingFormLayout = 'grid' | 'stack' | 'inline';
 export type BingFormLabelPosition = 'top' | 'left';
-export type BingFormValidateTrigger = 'change' | 'blur' | 'submit' | 'manual';
+export type BingFormValidateTrigger = 'auto' | 'change' | 'blur' | 'submit' | 'manual';
 export type BingFormBreakpoint = 'base' | 'sm' | 'md' | 'lg' | 'xl';
 export type BingFormResponsiveNumber = number | Partial<Record<BingFormBreakpoint, number>>;
 export type BingFormGap = string | number | {
@@ -23,8 +23,13 @@ export interface BingFormProps {
     labelWidth?: string | number;
     size?: BingFormSize;
     disabled?: boolean;
+    /** 默认 auto：离开字段或提交时校验，已有错误的字段在修改时重新检查。 */
     validateTrigger?: BingFormValidateTrigger | BingFormValidateTrigger[];
     scrollToError?: boolean;
+    /** 提交失败后聚焦第一个可用错误字段。默认 true；异步等待期间继续操作时不抢焦点。 */
+    focusOnError?: boolean;
+    /** 实验性：显示实际下一 Tab 落点的轻提示，不改写键盘行为；默认关闭。业务提交成功后可设为 false。 */
+    nextStepHint?: boolean;
 }
 export interface BingFormValidationResult {
     valid: boolean;

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

@@ -4,11 +4,11 @@ type __VLS_Slots = {} & {
     default?: (props: typeof __VLS_1) => any;
 };
 declare const __VLS_base: import('vue').DefineComponent<BingFormProps, BingFormExpose, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
-    submit: (payload: import('./BingForm.types').BingFormSubmitPayload) => any;
     invalid: (payload: BingFormValidationResult) => any;
+    submit: (payload: import('./BingForm.types').BingFormSubmitPayload) => any;
 }, string, import('vue').PublicProps, Readonly<BingFormProps> & Readonly<{
-    onSubmit?: ((payload: import('./BingForm.types').BingFormSubmitPayload) => any) | undefined;
     onInvalid?: ((payload: BingFormValidationResult) => any) | undefined;
+    onSubmit?: ((payload: import('./BingForm.types').BingFormSubmitPayload) => any) | undefined;
 }>, {
     disabled: boolean;
     columns: BingFormResponsiveNumber;
@@ -21,6 +21,8 @@ declare const __VLS_base: import('vue').DefineComponent<BingFormProps, BingFormE
     labelWidth: string | number;
     validateTrigger: BingFormValidateTrigger | BingFormValidateTrigger[];
     scrollToError: boolean;
+    focusOnError: boolean;
+    nextStepHint: boolean;
 }, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
 declare const __VLS_export: __VLS_WithSlots<typeof __VLS_base, __VLS_Slots>;
 declare const _default: typeof __VLS_export;

package/dist/components/BingForm/formFocus.d.ts

@@ -0,0 +1,3 @@
+export declare function isAvailableFormControl(element: HTMLElement | null): element is HTMLElement;
+/** 优先使用控件主入口；组内保留当前焦点或选中项，聚焦不改变值。 */
+export declare function findFormControlTarget(element: HTMLElement | null): HTMLElement | null;

package/dist/components/BingForm/formTabOrder.d.ts

@@ -0,0 +1,2 @@
+/** 返回确定的下一个原生 Tab 入口；不确定、即将离开表单时返回 null。 */
+export declare function nextFormTabStop(form: HTMLFormElement, active: HTMLElement): HTMLElement | null;

package/dist/components/BingForm/useFormControl.d.ts

@@ -0,0 +1,21 @@
+import { BingControlStatus } from './BingForm.types';
+export declare function useFormControl<Size extends string | number>(props: {
+    id?: string;
+    size?: Size;
+    disabled?: boolean;
+    status?: BingControlStatus;
+    ariaDescribedby?: string;
+}, options?: {
+    group?: boolean;
+    register?: boolean;
+}): {
+    formItem: import('./BingForm.context').BingFormItemContext | null;
+    resolvedId: import('vue').ComputedRef<string>;
+    resolvedSize: import('vue').ComputedRef<import('./BingForm.types').BingFormSize | Size>;
+    resolvedDisabled: import('vue').ComputedRef<boolean>;
+    resolvedStatus: import('vue').ComputedRef<BingControlStatus>;
+    resolvedAriaDescribedby: import('vue').ComputedRef<string | undefined>;
+    resolvedAriaLabelledby: import('vue').ComputedRef<string | undefined>;
+};
+/** 复合控件内部的搜索框、选项等不再注册为外部表单字段。 */
+export declare function isolateFormControls(): void;

package/dist/components/BingForm/useFormNextHint.d.ts

@@ -0,0 +1,16 @@
+import { CSSProperties, Ref } from 'vue';
+import { BingFormNextHintContext } from './BingForm.context';
+interface NextHint {
+    target: HTMLElement;
+    anchor: HTMLElement;
+    text: string;
+    offscreen: boolean;
+    submit: boolean;
+}
+/** 每个表单只有一个不可交互的提示；用户仍由浏览器原生 Tab 顺序导航。 */
+export declare function useFormNextHint(root: Ref<HTMLFormElement | null>, hintRef: Ref<HTMLElement | null>, enabled: () => boolean): {
+    context: BingFormNextHintContext;
+    hint: import('vue').ShallowRef<NextHint | null, NextHint | null>;
+    style: import('vue').ShallowRef<CSSProperties, CSSProperties>;
+};
+export {};