@robot-admin/naive-ui-components 0.16.0 → 0.17.1

package/dist/useCalendarEvents.d.cts

@@ -1,5 +1,4 @@
 import * as vue from "vue";
-import { Ref } from "vue";
 import { CalendarApi, CalendarOptions, EventApi } from "@fullcalendar/core";
 
 //#region src/components/C_FullCalendar/types.d.ts
@@ -22,6 +21,8 @@ interface CalendarEditForm {
   color: string;
 }
 interface CalendarProps {
+  /** 视图、布局与交互扩展；数据、插件和编辑开关由组件受控属性管理。 */
+  config?: Omit<CalendarOptions, 'events' | 'eventSources' | 'plugins' | 'initialView' | 'editable'>;
   events?: CalendarEvent[];
   initialView?: CalendarViewType;
   editable?: boolean;
@@ -66,9 +67,9 @@ declare const __VLS_export: vue.DefineComponent<CalendarProps, CalendarExpose, {
   }) => any) | undefined;
   "onEvent-dropped"?: ((event: Partial<CalendarEvent>) => any) | undefined;
 }>, {
-  events: CalendarEvent[];
-  initialView: CalendarViewType;
   editable: boolean;
+  initialView: CalendarViewType;
+  events: CalendarEvent[];
   showAddDialog: boolean;
   showEditDialog: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -105,19 +106,19 @@ type EmitFn = {
  *
  */
 declare function useCalendarEvents(props: CalendarProps, emit: EmitFn): {
-  calendarRef: Ref<{
+  calendarRef: vue.Ref<{
     getApi: () => CalendarApi;
   } | null, {
     getApi: () => CalendarApi;
   } | {
     getApi: () => CalendarApi;
   } | null>;
-  calendarOptions: Ref<CalendarOptions, CalendarOptions>;
-  showActionDialog: Ref<boolean, boolean>;
-  showEditModal: Ref<boolean, boolean>;
-  isEditing: Ref<boolean, boolean>;
+  calendarOptions: vue.ComputedRef<CalendarOptions>;
+  showActionDialog: vue.Ref<boolean, boolean>;
+  showEditModal: vue.Ref<boolean, boolean>;
+  isEditing: vue.Ref<boolean, boolean>;
   selectedEvent: vue.ShallowRef<EventApi | null, EventApi | null>;
-  editForm: Ref<{
+  editForm: vue.Ref<{
     id: string;
     title: string;
     date: number | null;

package/dist/useCalendarEvents.d.ts

@@ -1,5 +1,4 @@
 import * as vue from "vue";
-import { Ref } from "vue";
 import { CalendarApi, CalendarOptions, EventApi } from "@fullcalendar/core";
 
 //#region src/components/C_FullCalendar/types.d.ts
@@ -22,6 +21,8 @@ interface CalendarEditForm {
   color: string;
 }
 interface CalendarProps {
+  /** 视图、布局与交互扩展；数据、插件和编辑开关由组件受控属性管理。 */
+  config?: Omit<CalendarOptions, 'events' | 'eventSources' | 'plugins' | 'initialView' | 'editable'>;
   events?: CalendarEvent[];
   initialView?: CalendarViewType;
   editable?: boolean;
@@ -66,9 +67,9 @@ declare const __VLS_export: vue.DefineComponent<CalendarProps, CalendarExpose, {
   }) => any) | undefined;
   "onEvent-dropped"?: ((event: Partial<CalendarEvent>) => any) | undefined;
 }>, {
-  events: CalendarEvent[];
-  initialView: CalendarViewType;
   editable: boolean;
+  initialView: CalendarViewType;
+  events: CalendarEvent[];
   showAddDialog: boolean;
   showEditDialog: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -105,19 +106,19 @@ type EmitFn = {
  *
  */
 declare function useCalendarEvents(props: CalendarProps, emit: EmitFn): {
-  calendarRef: Ref<{
+  calendarRef: vue.Ref<{
     getApi: () => CalendarApi;
   } | null, {
     getApi: () => CalendarApi;
   } | {
     getApi: () => CalendarApi;
   } | null>;
-  calendarOptions: Ref<CalendarOptions, CalendarOptions>;
-  showActionDialog: Ref<boolean, boolean>;
-  showEditModal: Ref<boolean, boolean>;
-  isEditing: Ref<boolean, boolean>;
+  calendarOptions: vue.ComputedRef<CalendarOptions>;
+  showActionDialog: vue.Ref<boolean, boolean>;
+  showEditModal: vue.Ref<boolean, boolean>;
+  isEditing: vue.Ref<boolean, boolean>;
   selectedEvent: vue.ShallowRef<EventApi | null, EventApi | null>;
-  editForm: Ref<{
+  editForm: vue.Ref<{
     id: string;
     title: string;
     date: number | null;

package/dist/useCollapsePanel.d.cts

@@ -71,19 +71,19 @@ declare var __VLS_7: `header-${string}`, __VLS_8: {
 type __VLS_Slots = {} & { [K in NonNullable<typeof __VLS_7>]?: (props: typeof __VLS_8) => any } & { [K in NonNullable<typeof __VLS_16>]?: (props: typeof __VLS_17) => any } & { [K in NonNullable<typeof __VLS_31>]?: (props: typeof __VLS_32) => any };
 declare const __VLS_base: vue.DefineComponent<Props, CollapsePanelExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   change: (activeKeys: string[]) => any;
-  "update:activeKeys": (keys: string[]) => any;
   expand: (key: string) => any;
   collapse: (key: string) => any;
+  "update:activeKeys": (keys: string[]) => any;
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onChange?: ((activeKeys: string[]) => any) | undefined;
-  "onUpdate:activeKeys"?: ((keys: string[]) => any) | undefined;
   onExpand?: ((key: string) => any) | undefined;
   onCollapse?: ((key: string) => any) | undefined;
+  "onUpdate:activeKeys"?: ((keys: string[]) => any) | undefined;
 }>, {
+  accordion: boolean;
   bordered: boolean;
   activeKeys: string[];
   defaultActiveKeys: string[];
-  accordion: boolean;
   variant: CollapsePanelVariant;
   expandIconPosition: ExpandIconPosition;
   persistKey: string;

package/dist/useCollapsePanel.d.ts

@@ -71,19 +71,19 @@ declare var __VLS_7: `header-${string}`, __VLS_8: {
 type __VLS_Slots = {} & { [K in NonNullable<typeof __VLS_7>]?: (props: typeof __VLS_8) => any } & { [K in NonNullable<typeof __VLS_16>]?: (props: typeof __VLS_17) => any } & { [K in NonNullable<typeof __VLS_31>]?: (props: typeof __VLS_32) => any };
 declare const __VLS_base: vue.DefineComponent<Props, CollapsePanelExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   change: (activeKeys: string[]) => any;
-  "update:activeKeys": (keys: string[]) => any;
   expand: (key: string) => any;
   collapse: (key: string) => any;
+  "update:activeKeys": (keys: string[]) => any;
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onChange?: ((activeKeys: string[]) => any) | undefined;
-  "onUpdate:activeKeys"?: ((keys: string[]) => any) | undefined;
   onExpand?: ((key: string) => any) | undefined;
   onCollapse?: ((key: string) => any) | undefined;
+  "onUpdate:activeKeys"?: ((keys: string[]) => any) | undefined;
 }>, {
+  accordion: boolean;
   bordered: boolean;
   activeKeys: string[];
   defaultActiveKeys: string[];
-  accordion: boolean;
   variant: CollapsePanelVariant;
   expandIconPosition: ExpandIconPosition;
   persistKey: string;

package/dist/useCropperCore.d.cts

@@ -51,28 +51,28 @@ interface ImageCropperEmits {
 //#endregion
 //#region src/components/C_ImageCropper/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<ImageCropperProps, ImageCropperExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  crop: (result: CropResult) => any;
-  ready: () => any;
   error: (error: Error) => any;
-  confirm: (result: CropResult) => any;
   cancel: () => any;
+  ready: () => any;
+  crop: (result: CropResult) => any;
+  confirm: (result: CropResult) => any;
 }, string, vue.PublicProps, Readonly<ImageCropperProps> & Readonly<{
-  onCrop?: ((result: CropResult) => any) | undefined;
-  onReady?: (() => any) | undefined;
   onError?: ((error: Error) => any) | undefined;
-  onConfirm?: ((result: CropResult) => any) | undefined;
   onCancel?: (() => any) | undefined;
+  onReady?: (() => any) | undefined;
+  onCrop?: ((result: CropResult) => any) | undefined;
+  onConfirm?: ((result: CropResult) => any) | undefined;
 }>, {
-  disabled: boolean;
   height: string | number;
-  showPreview: boolean;
+  disabled: boolean;
+  showToolbar: boolean;
   src: string;
   aspectRatio: number;
   outputFormat: CropOutputFormat;
   outputQuality: number;
   maxOutputWidth: number;
   maxOutputHeight: number;
-  showToolbar: boolean;
+  showPreview: boolean;
   circular: boolean;
   modal: boolean;
   modalTitle: string;

package/dist/useCropperCore.d.ts

@@ -51,28 +51,28 @@ interface ImageCropperEmits {
 //#endregion
 //#region src/components/C_ImageCropper/index.vue.d.ts
 declare const __VLS_export: vue.DefineComponent<ImageCropperProps, ImageCropperExpose, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
-  crop: (result: CropResult) => any;
-  ready: () => any;
   error: (error: Error) => any;
-  confirm: (result: CropResult) => any;
   cancel: () => any;
+  ready: () => any;
+  crop: (result: CropResult) => any;
+  confirm: (result: CropResult) => any;
 }, string, vue.PublicProps, Readonly<ImageCropperProps> & Readonly<{
-  onCrop?: ((result: CropResult) => any) | undefined;
-  onReady?: (() => any) | undefined;
   onError?: ((error: Error) => any) | undefined;
-  onConfirm?: ((result: CropResult) => any) | undefined;
   onCancel?: (() => any) | undefined;
+  onReady?: (() => any) | undefined;
+  onCrop?: ((result: CropResult) => any) | undefined;
+  onConfirm?: ((result: CropResult) => any) | undefined;
 }>, {
-  disabled: boolean;
   height: string | number;
-  showPreview: boolean;
+  disabled: boolean;
+  showToolbar: boolean;
   src: string;
   aspectRatio: number;
   outputFormat: CropOutputFormat;
   outputQuality: number;
   maxOutputWidth: number;
   maxOutputHeight: number;
-  showToolbar: boolean;
+  showPreview: boolean;
   circular: boolean;
   modal: boolean;
   modalTitle: string;

package/dist/useDraggableLayout.d.cts

@@ -1,4 +1,5 @@
 import * as vue from "vue";
+import { DraggableEvent } from "vue-draggable-plus";
 
 //#region src/components/C_Draggable/types.d.ts
 interface DraggableItem {
@@ -117,30 +118,30 @@ declare const __VLS_base: vue.DefineComponent<DraggableProps, {
   "onList-change"?: ((list: DraggableItem[]) => any) | undefined;
 }>, {
   sort: boolean;
-  emptyText: string;
-  modelValue: DraggableItem[];
   disabled: boolean;
+  delay: number;
+  modelValue: DraggableItem[];
+  gap: string | number;
+  justifyContent: JustifyContent;
+  animation: number;
+  wrapperClass: string;
+  itemClass: string;
   layout: LayoutMode;
+  direction: "vertical" | "horizontal";
+  emptyText: string;
   group: string | GroupOptions;
-  animation: number;
-  delay: number;
   handle: string;
   showHandle: boolean;
   ghostClass: string;
   chosenClass: string;
   dragClass: string;
-  wrapperClass: string;
   listClass: string;
-  itemClass: string;
   showEmptyState: boolean;
   swapThreshold: number;
   invertSwap: boolean;
-  direction: "vertical" | "horizontal";
   gridColumns: number;
   gridRows: number;
-  gap: string | number;
   flexWrap: boolean;
-  justifyContent: JustifyContent;
   alignItems: AlignItems;
   customStyles: Record<string, string | number>;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -153,6 +154,7 @@ type __VLS_WithSlots<T, S> = T & {
 };
 //#endregion
 //#region src/components/C_Draggable/composables/useDraggableLayout.d.ts
+type LayoutDragEvent = Partial<Pick<DraggableEvent<DraggableItem>, 'data' | 'clonedData' | 'oldIndex' | 'newIndex' | 'oldDraggableIndex' | 'newDraggableIndex' | 'from' | 'to' | 'pullMode'>>;
 type EmitFn = {
   (event: 'update:modelValue', value: DraggableItem[]): void;
   (event: 'drag-start', dragEvent: DragEvent): void;
@@ -179,10 +181,10 @@ declare function useDraggableLayout(props: DraggableProps, emit: EmitFn): {
   getItemClass: () => (string | {
     'is-disabled': boolean | undefined;
   } | undefined)[];
-  handleStart: (event: any) => void;
-  handleEnd: (event: any) => void;
-  handleAdd: (event: any) => void;
-  handleRemove: (event: any) => void;
+  handleStart: (event: LayoutDragEvent) => void;
+  handleEnd: (event: LayoutDragEvent) => void;
+  handleAdd: (event: LayoutDragEvent) => void;
+  handleRemove: (event: LayoutDragEvent) => void;
   handleUpdate: () => void;
   addItem: (item: DraggableItem, index?: number) => void;
   removeItem: (index: number) => DraggableItem | null;

package/dist/useDraggableLayout.d.ts

@@ -1,4 +1,5 @@
 import * as vue from "vue";
+import { DraggableEvent } from "vue-draggable-plus";
 
 //#region src/components/C_Draggable/types.d.ts
 interface DraggableItem {
@@ -117,30 +118,30 @@ declare const __VLS_base: vue.DefineComponent<DraggableProps, {
   "onList-change"?: ((list: DraggableItem[]) => any) | undefined;
 }>, {
   sort: boolean;
-  emptyText: string;
-  modelValue: DraggableItem[];
   disabled: boolean;
+  delay: number;
+  modelValue: DraggableItem[];
+  gap: string | number;
+  justifyContent: JustifyContent;
+  animation: number;
+  wrapperClass: string;
+  itemClass: string;
   layout: LayoutMode;
+  direction: "vertical" | "horizontal";
+  emptyText: string;
   group: string | GroupOptions;
-  animation: number;
-  delay: number;
   handle: string;
   showHandle: boolean;
   ghostClass: string;
   chosenClass: string;
   dragClass: string;
-  wrapperClass: string;
   listClass: string;
-  itemClass: string;
   showEmptyState: boolean;
   swapThreshold: number;
   invertSwap: boolean;
-  direction: "vertical" | "horizontal";
   gridColumns: number;
   gridRows: number;
-  gap: string | number;
   flexWrap: boolean;
-  justifyContent: JustifyContent;
   alignItems: AlignItems;
   customStyles: Record<string, string | number>;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -153,6 +154,7 @@ type __VLS_WithSlots<T, S> = T & {
 };
 //#endregion
 //#region src/components/C_Draggable/composables/useDraggableLayout.d.ts
+type LayoutDragEvent = Partial<Pick<DraggableEvent<DraggableItem>, 'data' | 'clonedData' | 'oldIndex' | 'newIndex' | 'oldDraggableIndex' | 'newDraggableIndex' | 'from' | 'to' | 'pullMode'>>;
 type EmitFn = {
   (event: 'update:modelValue', value: DraggableItem[]): void;
   (event: 'drag-start', dragEvent: DragEvent): void;
@@ -179,10 +181,10 @@ declare function useDraggableLayout(props: DraggableProps, emit: EmitFn): {
   getItemClass: () => (string | {
     'is-disabled': boolean | undefined;
   } | undefined)[];
-  handleStart: (event: any) => void;
-  handleEnd: (event: any) => void;
-  handleAdd: (event: any) => void;
-  handleRemove: (event: any) => void;
+  handleStart: (event: LayoutDragEvent) => void;
+  handleEnd: (event: LayoutDragEvent) => void;
+  handleAdd: (event: LayoutDragEvent) => void;
+  handleRemove: (event: LayoutDragEvent) => void;
   handleUpdate: () => void;
   addItem: (item: DraggableItem, index?: number) => void;
   removeItem: (index: number) => DraggableItem | null;

package/dist/useDynamicFormState.d.cts

@@ -1,4 +1,5 @@
 import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.cjs";
+import { t as ComponentDensity } from "./density.cjs";
 import * as vue from "vue";
 import { CSSProperties, Component, ComputedRef, DeepReadonly, InjectionKey, MaybeRefOrGetter, Ref, ShallowRef, Slots, VNode } from "vue";
 import { FormInst, FormItemInst, FormItemRule, FormRules } from "naive-ui";
@@ -485,6 +486,8 @@ interface FormConfig<T extends object = FormRecord> extends LayoutCallbacks<T> {
   labelWidth?: string | number;
   /** 尺寸，默认 'medium' */
   size?: 'small' | 'medium' | 'large';
+  /** 与表格、搜索表单一致的密度；显式 size 和布局间距优先。 */
+  density?: ComponentDensity;
   /** 禁用整个表单，默认 false */
   disabled?: boolean;
   /** 只读，默认 false */
@@ -634,8 +637,8 @@ declare const __VLS_export: <T extends object = FormRecord>(__VLS_props: NonNull
     config?: FormConfig<T>; /** 当前表单实例的自定义渲染器，不污染全局注册表 */
     renderers?: Record<string, FormRenderer>;
   } & {
-    "onUpdate:modelValue"?: ((model: T) => any) | undefined;
     onSubmit?: ((payload: SubmitEventPayload<T>) => any) | undefined;
+    "onUpdate:modelValue"?: ((model: T) => any) | undefined;
     "onValidate-success"?: ((model: T) => any) | undefined;
     "onValidate-error"?: ((errors: unknown) => any) | undefined;
   }> & (typeof globalThis extends {
@@ -672,7 +675,7 @@ declare const __VLS_export: <T extends object = FormRecord>(__VLS_props: NonNull
   }>) => void;
   attrs: any;
   slots: FormSlots<T>;
-  emit: ((evt: "update:modelValue", model: T) => void) & ((evt: "submit", payload: SubmitEventPayload<T>) => void) & ((evt: "validate-success", model: T) => void) & ((evt: "validate-error", errors: unknown) => void);
+  emit: ((evt: "submit", payload: SubmitEventPayload<T>) => void) & ((evt: "update:modelValue", model: T) => void) & ((evt: "validate-success", model: T) => void) & ((evt: "validate-error", errors: unknown) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/useDynamicFormState.d.ts

@@ -1,4 +1,5 @@
 import { n as ComponentLocale, t as ComponentFeedback } from "./contracts.js";
+import { t as ComponentDensity } from "./density.js";
 import * as vue from "vue";
 import { CSSProperties, Component, ComputedRef, DeepReadonly, InjectionKey, MaybeRefOrGetter, Ref, ShallowRef, Slots, VNode } from "vue";
 import { FormInst, FormItemInst, FormItemRule, FormRules } from "naive-ui";
@@ -485,6 +486,8 @@ interface FormConfig<T extends object = FormRecord> extends LayoutCallbacks<T> {
   labelWidth?: string | number;
   /** 尺寸，默认 'medium' */
   size?: 'small' | 'medium' | 'large';
+  /** 与表格、搜索表单一致的密度；显式 size 和布局间距优先。 */
+  density?: ComponentDensity;
   /** 禁用整个表单，默认 false */
   disabled?: boolean;
   /** 只读，默认 false */
@@ -634,8 +637,8 @@ declare const __VLS_export: <T extends object = FormRecord>(__VLS_props: NonNull
     config?: FormConfig<T>; /** 当前表单实例的自定义渲染器，不污染全局注册表 */
     renderers?: Record<string, FormRenderer>;
   } & {
-    "onUpdate:modelValue"?: ((model: T) => any) | undefined;
     onSubmit?: ((payload: SubmitEventPayload<T>) => any) | undefined;
+    "onUpdate:modelValue"?: ((model: T) => any) | undefined;
     "onValidate-success"?: ((model: T) => any) | undefined;
     "onValidate-error"?: ((errors: unknown) => any) | undefined;
   }> & (typeof globalThis extends {
@@ -672,7 +675,7 @@ declare const __VLS_export: <T extends object = FormRecord>(__VLS_props: NonNull
   }>) => void;
   attrs: any;
   slots: FormSlots<T>;
-  emit: ((evt: "update:modelValue", model: T) => void) & ((evt: "submit", payload: SubmitEventPayload<T>) => void) & ((evt: "validate-success", model: T) => void) & ((evt: "validate-error", errors: unknown) => void);
+  emit: ((evt: "submit", payload: SubmitEventPayload<T>) => void) & ((evt: "update:modelValue", model: T) => void) & ((evt: "validate-success", model: T) => void) & ((evt: "validate-error", errors: unknown) => void);
 }>) => vue.VNode & {
   __ctx?: NonNullable<Awaited<typeof __VLS_setup>>;
 };

package/dist/useEdgeInteraction.d.cts

@@ -259,11 +259,11 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
-  height: string | number;
-  showToolbar: boolean;
+  theme: "light" | "dark";
   width: string | number;
+  height: string | number;
   readonly: boolean;
-  theme: "light" | "dark";
+  showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/useEdgeInteraction.d.ts

@@ -259,11 +259,11 @@ declare const __VLS_export: vue.DefineComponent<Props, {
   onReady?: ((graph: Graph) => any) | undefined;
   "onData-change"?: ((data: DiagramData) => any) | undefined;
 }>, {
-  height: string | number;
-  showToolbar: boolean;
+  theme: "light" | "dark";
   width: string | number;
+  height: string | number;
   readonly: boolean;
-  theme: "light" | "dark";
+  showToolbar: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;
 //#endregion

package/dist/useFullscreen.d.cts

@@ -7,6 +7,7 @@ type __VLS_Props = {
   url?: string;
   fileName?: string;
   autoPreview?: boolean;
+  inline?: boolean;
 };
 declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   download: (file: string | File) => any;
@@ -15,6 +16,7 @@ declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue
   onDownload?: ((file: string | File) => any) | undefined;
   onPreview?: ((file: string | File) => any) | undefined;
 }>, {
+  inline: boolean;
   fileName: string;
   autoPreview: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -77,6 +79,8 @@ interface FilePreviewProps {
   url?: string;
   fileName?: string;
   autoPreview?: boolean;
+  /** 在容器中直接阅读文档，默认保留原有弹窗模式。 */
+  inline?: boolean;
 }
 /** 文件加载结果 — PDF */
 interface PdfLoadResult {

package/dist/useFullscreen.d.ts

@@ -7,6 +7,7 @@ type __VLS_Props = {
   url?: string;
   fileName?: string;
   autoPreview?: boolean;
+  inline?: boolean;
 };
 declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue.ComponentOptionsMixin, vue.ComponentOptionsMixin, {
   download: (file: string | File) => any;
@@ -15,6 +16,7 @@ declare const __VLS_export: vue.DefineComponent<__VLS_Props, {}, {}, {}, {}, vue
   onDownload?: ((file: string | File) => any) | undefined;
   onPreview?: ((file: string | File) => any) | undefined;
 }>, {
+  inline: boolean;
   fileName: string;
   autoPreview: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
@@ -77,6 +79,8 @@ interface FilePreviewProps {
   url?: string;
   fileName?: string;
   autoPreview?: boolean;
+  /** 在容器中直接阅读文档，默认保留原有弹窗模式。 */
+  inline?: boolean;
 }
 /** 文件加载结果 — PDF */
 interface PdfLoadResult {

package/dist/useGlobalSearch.d.cts

@@ -1,4 +1,5 @@
 import * as vue from "vue";
+import { MaybeRefOrGetter } from "vue";
 
 //#region src/components/C_GlobalSearch/types.d.ts
 type SearchIcon = string | object | ((...args: unknown[]) => unknown);
@@ -64,7 +65,7 @@ declare const _default: typeof __VLS_export;
  * 已解耦：不依赖任何项目级 store / router，
  * 所有外部数据通过 options 注入。
  */
-declare function useGlobalSearch(options: GlobalSearchOptions): {
+declare function useGlobalSearch(options: MaybeRefOrGetter<GlobalSearchOptions>): {
   showDialog: vue.Ref<boolean, boolean>;
   searchValue: vue.Ref<string, string>;
   selectedIndex: vue.Ref<number, number>;
@@ -102,9 +103,13 @@ declare function useGlobalSearch(options: GlobalSearchOptions): {
   closeDialog: () => void;
   selectHistoryItem: (historyItem: HistoryItem) => void;
   selectItem: (item: SearchMenuItem) => void;
-  handleEnter: () => void;
-  focusNext: () => void;
-  focusPrev: () => void;
+  handleEnter: (event?: KeyboardEvent) => void;
+  focusNext: (event?: KeyboardEvent) => void;
+  focusPrev: (event?: KeyboardEvent) => void;
+  handleInputKeydown: (event: KeyboardEvent) => void;
+  handleDialogKeydown: (event: KeyboardEvent) => void;
+  handleCompositionStart: () => void;
+  handleCompositionEnd: () => void;
 };
 //#endregion
 export { SearchMenuItem as a, HistoryItem as i, _default as n, GlobalSearchOptions as r, useGlobalSearch as t };

package/dist/useGlobalSearch.d.ts

@@ -1,4 +1,5 @@
 import * as vue from "vue";
+import { MaybeRefOrGetter } from "vue";
 
 //#region src/components/C_GlobalSearch/types.d.ts
 type SearchIcon = string | object | ((...args: unknown[]) => unknown);
@@ -64,7 +65,7 @@ declare const _default: typeof __VLS_export;
  * 已解耦：不依赖任何项目级 store / router，
  * 所有外部数据通过 options 注入。
  */
-declare function useGlobalSearch(options: GlobalSearchOptions): {
+declare function useGlobalSearch(options: MaybeRefOrGetter<GlobalSearchOptions>): {
   showDialog: vue.Ref<boolean, boolean>;
   searchValue: vue.Ref<string, string>;
   selectedIndex: vue.Ref<number, number>;
@@ -102,9 +103,13 @@ declare function useGlobalSearch(options: GlobalSearchOptions): {
   closeDialog: () => void;
   selectHistoryItem: (historyItem: HistoryItem) => void;
   selectItem: (item: SearchMenuItem) => void;
-  handleEnter: () => void;
-  focusNext: () => void;
-  focusPrev: () => void;
+  handleEnter: (event?: KeyboardEvent) => void;
+  focusNext: (event?: KeyboardEvent) => void;
+  focusPrev: (event?: KeyboardEvent) => void;
+  handleInputKeydown: (event: KeyboardEvent) => void;
+  handleDialogKeydown: (event: KeyboardEvent) => void;
+  handleCompositionStart: () => void;
+  handleCompositionEnd: () => void;
 };
 //#endregion
 export { SearchMenuItem as a, HistoryItem as i, _default as n, GlobalSearchOptions as r, useGlobalSearch as t };

package/dist/useInfiniteScroll.d.cts

@@ -129,7 +129,9 @@ declare function useResponsiveColumns(containerRef: Ref<HTMLElement | undefined>
 /**
  *
  */
-declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readonly<Ref<number>>, containerWidth: Readonly<Ref<number>>, gap: Ref<number>): {
+declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readonly<Ref<number>>, containerWidth: Readonly<Ref<number>>, gap: Ref<number>, options?: {
+  batchImageLoads?: boolean;
+}): {
   layoutItems: Readonly<Ref<readonly {
     readonly item: {
       readonly [x: string]: any;
@@ -163,6 +165,7 @@ declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readon
   }[]>>;
   containerHeight: Readonly<Ref<number, number>>;
   cacheImageHeight: (id: string | number, realHeight: number, basisWidth?: number, src?: string) => void;
+  cacheItemExtraHeight: (id: string | number, extraHeight: number) => void;
   relayout: () => void;
 };
 //#endregion

package/dist/useInfiniteScroll.d.ts

@@ -129,7 +129,9 @@ declare function useResponsiveColumns(containerRef: Ref<HTMLElement | undefined>
 /**
  *
  */
-declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readonly<Ref<number>>, containerWidth: Readonly<Ref<number>>, gap: Ref<number>): {
+declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readonly<Ref<number>>, containerWidth: Readonly<Ref<number>>, gap: Ref<number>, options?: {
+  batchImageLoads?: boolean;
+}): {
   layoutItems: Readonly<Ref<readonly {
     readonly item: {
       readonly [x: string]: any;
@@ -163,6 +165,7 @@ declare function useWaterFallLayout(items: Ref<WaterFallItem[]>, columns: Readon
   }[]>>;
   containerHeight: Readonly<Ref<number, number>>;
   cacheImageHeight: (id: string | number, realHeight: number, basisWidth?: number, src?: string) => void;
+  cacheItemExtraHeight: (id: string | number, extraHeight: number) => void;
   relayout: () => void;
 };
 //#endregion

package/dist/useQRCode.d.cts

@@ -50,15 +50,15 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  size: number;
-  label: string;
   color: string;
   mode: RenderMode;
+  size: number;
+  label: string;
+  showBorder: boolean;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
   margin: number;
   logo: LogoOptions;
-  showBorder: boolean;
   showLabel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;

package/dist/useQRCode.d.ts

@@ -50,15 +50,15 @@ declare const __VLS_export: vue.DefineComponent<Props, QRCodeExpose, {}, {}, {},
 }, string, vue.PublicProps, Readonly<Props> & Readonly<{
   onError?: ((error: Error) => any) | undefined;
 }>, {
-  size: number;
-  label: string;
   color: string;
   mode: RenderMode;
+  size: number;
+  label: string;
+  showBorder: boolean;
   bgColor: string;
   errorCorrectionLevel: ErrorCorrectionLevel;
   margin: number;
   logo: LogoOptions;
-  showBorder: boolean;
   showLabel: boolean;
 }, {}, {}, {}, string, vue.ComponentProvideOptions, false, {}, any>;
 declare const _default: typeof __VLS_export;