@owocow/saber-ui 0.0.2 → 0.0.3

package/dist/forms/components/fields/SaberDistrictSelect.vue.d.ts

@@ -0,0 +1,31 @@
+import { DistrictNode, DistrictValue } from '../../types';
+type __VLS_Props = {
+    districts?: readonly DistrictNode[];
+    placeholder?: string;
+    clearable?: boolean;
+    disabled?: boolean;
+    loading?: boolean;
+};
+type __VLS_PublicProps = {
+    modelValue?: DistrictValue | undefined;
+} & __VLS_Props;
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {
+    districts: import('vue').ComputedRef<readonly DistrictNode[]>;
+    loading: import('vue').ComputedRef<boolean>;
+    error: import('vue').ComputedRef<{} | null>;
+    reload: () => Promise<readonly DistrictNode[]> | undefined;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: DistrictValue | undefined) => any;
+    "update:modelValue": (value: DistrictValue | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: DistrictValue | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: DistrictValue | undefined) => any) | undefined;
+}>, {
+    loading: boolean;
+    placeholder: string;
+    disabled: boolean;
+    clearable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {
+    searchInputRef: unknown;
+}, any>;
+export default _default;

package/dist/forms/components/fields/SaberInput.vue.d.ts

@@ -0,0 +1,16 @@
+type __VLS_Props = {
+    clearable?: boolean;
+};
+type __VLS_PublicProps = {
+    modelValue?: string | number | undefined;
+} & __VLS_Props;
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: string | number | undefined) => any;
+    "update:modelValue": (value: string | number | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: string | number | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | number | undefined) => any) | undefined;
+}>, {
+    clearable: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/forms/components/fields/SaberInputNumber.vue.d.ts

@@ -0,0 +1,11 @@
+type __VLS_PublicProps = {
+    modelValue?: number | undefined;
+};
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: number | undefined) => any;
+    "update:modelValue": (value: number | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: number | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: number | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/forms/components/fields/SaberPopSelect.vue.d.ts

@@ -0,0 +1,25 @@
+import { PopSelectOption } from '../../types';
+type __VLS_Props = {
+    items?: PopSelectOption[];
+    placeholder?: string;
+    multiple?: boolean;
+    clearable?: boolean;
+    disabled?: boolean;
+};
+type __VLS_PublicProps = {
+    modelValue?: any;
+} & __VLS_Props;
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: any) => any;
+    "update:modelValue": (value: any) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: any) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {
+    placeholder: string;
+    disabled: boolean;
+    clearable: boolean;
+    items: PopSelectOption[];
+    multiple: boolean;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/forms/components/fields/SaberRadioGroup.vue.d.ts

@@ -0,0 +1,11 @@
+type __VLS_PublicProps = {
+    modelValue?: any;
+};
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: any) => any;
+    "update:modelValue": (value: any) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: any) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/forms/components/fields/SaberSelect.vue.d.ts

@@ -0,0 +1,11 @@
+type __VLS_PublicProps = {
+    modelValue?: any;
+};
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: any) => any;
+    "update:modelValue": (value: any) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: any) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/forms/components/fields/SaberTextarea.vue.d.ts

@@ -0,0 +1,11 @@
+type __VLS_PublicProps = {
+    modelValue?: string | undefined;
+};
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    change: (value: string | undefined) => any;
+    "update:modelValue": (value: string | undefined) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onChange?: ((value: string | undefined) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: string | undefined) => any) | undefined;
+}>, {}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, any>;
+export default _default;

package/dist/forms/components/fields/SaberUploadImage.vue.d.ts

@@ -0,0 +1,113 @@
+import { UploadImageDataSource } from '../../types';
+type UploadOrigin = 'initial' | 'uploaded';
+type UploadStatus = 'uploading' | 'success' | 'error';
+interface UploadItem {
+    uid: string;
+    key?: string | number;
+    name: string;
+    status: UploadStatus;
+    percent: number;
+    url: string;
+    value?: any;
+    origin: UploadOrigin;
+    removing: boolean;
+    controller?: AbortController;
+    error?: string;
+}
+type __VLS_Props = {
+    /** 覆盖 app.use(SaberUI) 配置的全局上传数据源。 */
+    dataSource?: UploadImageDataSource<any>;
+    multiple?: boolean;
+    max?: number;
+    maxSize?: number;
+    accept?: string;
+    disabled?: boolean;
+    size?: string;
+};
+type __VLS_PublicProps = {
+    modelValue?: any | any[] | null;
+} & __VLS_Props;
+declare const _default: import('vue').DefineComponent<__VLS_PublicProps, {
+    items: import('vue').Ref<{
+        uid: string;
+        key?: string | number | undefined;
+        name: string;
+        status: UploadStatus;
+        percent: number;
+        url: string;
+        value?: any;
+        origin: UploadOrigin;
+        removing: boolean;
+        controller?: {
+            readonly signal: {
+                readonly aborted: boolean;
+                onabort: ((this: AbortSignal, ev: Event) => any) | null;
+                readonly reason: any;
+                throwIfAborted: () => void;
+                addEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+                };
+                removeEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+                };
+                dispatchEvent: (event: Event) => boolean;
+            };
+            abort: (reason?: any) => void;
+        } | undefined;
+        error?: string | undefined;
+    }[], UploadItem[] | {
+        uid: string;
+        key?: string | number | undefined;
+        name: string;
+        status: UploadStatus;
+        percent: number;
+        url: string;
+        value?: any;
+        origin: UploadOrigin;
+        removing: boolean;
+        controller?: {
+            readonly signal: {
+                readonly aborted: boolean;
+                onabort: ((this: AbortSignal, ev: Event) => any) | null;
+                readonly reason: any;
+                throwIfAborted: () => void;
+                addEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | AddEventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | AddEventListenerOptions): void;
+                };
+                removeEventListener: {
+                    <K extends keyof AbortSignalEventMap>(type: K, listener: (this: AbortSignal, ev: AbortSignalEventMap[K]) => any, options?: boolean | EventListenerOptions): void;
+                    (type: string, listener: EventListenerOrEventListenerObject, options?: boolean | EventListenerOptions): void;
+                };
+                dispatchEvent: (event: Event) => boolean;
+            };
+            abort: (reason?: any) => void;
+        } | undefined;
+        error?: string | undefined;
+    }[]>;
+    /** 只清理本地状态和 model，不调用远程 remove。 */
+    clear(): void;
+}, {}, {}, {}, import('vue').ComponentOptionsMixin, import('vue').ComponentOptionsMixin, {
+    progress: (percent: number, file: File) => any;
+    error: (error: Error, file: File) => any;
+    success: (value: any) => any;
+    "update:modelValue": (value: any) => any;
+    removeError: (error: Error, value: any) => any;
+}, string, import('vue').PublicProps, Readonly<__VLS_PublicProps> & Readonly<{
+    onProgress?: ((percent: number, file: File) => any) | undefined;
+    onError?: ((error: Error, file: File) => any) | undefined;
+    onSuccess?: ((value: any) => any) | undefined;
+    "onUpdate:modelValue"?: ((value: any) => any) | undefined;
+    onRemoveError?: ((error: Error, value: any) => any) | undefined;
+}>, {
+    disabled: boolean;
+    size: string;
+    dataSource: UploadImageDataSource<any>;
+    multiple: boolean;
+    max: number;
+    maxSize: number;
+    accept: string;
+}, {}, {}, {}, string, import('vue').ComponentProvideOptions, false, {}, HTMLDivElement>;
+export default _default;

package/dist/forms/dict-checkbox.mjs

@@ -0,0 +1,4 @@
+import { _ as f } from "../SaberDictCheckbox.vue_vue_type_script_setup_true_lang-DUbzy_C6.js";
+export {
+  f as default
+};

package/dist/forms/dict-radio.mjs

@@ -0,0 +1,4 @@
+import { _ as f } from "../SaberDictRadio.vue_vue_type_script_setup_true_lang-DR6-jSID.js";
+export {
+  f as default
+};

package/dist/forms/dict-select.mjs

@@ -0,0 +1,4 @@
+import { _ as f } from "../SaberDictSelect.vue_vue_type_script_setup_true_lang-B8PTKNKX.js";
+export {
+  f as default
+};

package/dist/forms/dict-source.d.ts

@@ -0,0 +1,3 @@
+import { InjectionKey } from 'vue';
+import { DictDataSource } from './types';
+export declare const DictDataSourceKey: InjectionKey<DictDataSource>;

package/dist/forms/district-select.mjs

@@ -0,0 +1,4 @@
+import { _ as f } from "../SaberDistrictSelect.vue_vue_type_script_setup_true_lang-BX8nLC35.js";
+export {
+  f as default
+};

package/dist/forms/district-service.d.ts

@@ -0,0 +1,46 @@
+import { InjectionKey, Ref, ShallowRef } from 'vue';
+import { DistrictNode } from './types';
+export interface ResolvedDistrict {
+    province: string;
+    provinceCode: string;
+    city: string | null;
+    cityCode: string | null;
+    district: string | null;
+    districtCode: string | null;
+}
+/** 行政区划数据源；请求协议、鉴权和持久化缓存由具体实现负责。 */
+export interface DistrictDataSource {
+    loadDistricts(): readonly DistrictNode[] | Promise<readonly DistrictNode[]>;
+}
+export interface DistrictService {
+    readonly districts: Readonly<ShallowRef<readonly DistrictNode[]>>;
+    readonly loading: Readonly<Ref<boolean>>;
+    readonly error: Readonly<ShallowRef<unknown>>;
+    load(force?: boolean): Promise<readonly DistrictNode[]>;
+    resolveByCode(code: string | number): ResolvedDistrict | null;
+}
+export interface AmapDistrictDataSourceOptions {
+    /** 高德 Web 服务 Key。该 Key 会出现在浏览器请求中，应在高德控制台配置安全限制。 */
+    key: string;
+    /** 默认缓存 7 天；设为 0 可关闭 localStorage 缓存。 */
+    cacheTtl?: number;
+    cacheKey?: string;
+    fetcher?: typeof fetch;
+}
+export interface SaberDistrictOptions {
+    /** 自定义数据源优先于 amapKey。 */
+    dataSource?: DistrictDataSource;
+    /** 使用 saber-ui 内置高德数据源时只需配置此项。 */
+    amapKey?: string;
+    cacheTtl?: number;
+    cacheKey?: string;
+    fetcher?: typeof fetch;
+}
+export declare const DistrictServiceKey: InjectionKey<DistrictService>;
+/** 创建高德行政区划数据源，返回的树从省级节点开始。 */
+export declare function createAmapDistrictDataSource(options: AmapDistrictDataSourceOptions): DistrictDataSource;
+export declare function resolveDistrictDataSource(options?: SaberDistrictOptions): DistrictDataSource | undefined;
+/** 创建 app 级共享服务；内存数据和在途请求由选择组件与地址解析器共同复用。 */
+export declare function createDistrictService(dataSource?: DistrictDataSource): DistrictService;
+/** 必须在已安装 SaberUI 的 Vue setup 作用域内调用。 */
+export declare function useDistrictService(): DistrictService;

package/dist/forms/filter-state.d.ts

@@ -0,0 +1,4 @@
+import { FilterField } from './types';
+export declare function hasMeaningfulValue(value: unknown): boolean;
+export declare function isSameFormValue(a: unknown, b: unknown): boolean;
+export declare function hasActiveFilterValues(params: Record<string, unknown>, fields: FilterField[], initialParams?: Record<string, unknown> | null): boolean;

package/dist/forms/index.d.ts

@@ -0,0 +1,24 @@
+export { default as SaberFilterBar } from './components/SaberFilterBar.vue';
+export { default as SaberFormModal } from './components/SaberFormModal.vue';
+export { default as SaberModal } from './components/SaberModal.vue';
+export { default as SaberInput } from './components/fields/SaberInput.vue';
+export { default as SaberInputNumber } from './components/fields/SaberInputNumber.vue';
+export { default as SaberDictCheckbox } from './components/fields/SaberDictCheckbox.vue';
+export { default as SaberDictRadio } from './components/fields/SaberDictRadio.vue';
+export { default as SaberDictSelect } from './components/fields/SaberDictSelect.vue';
+export { default as SaberRadioGroup } from './components/fields/SaberRadioGroup.vue';
+export { default as SaberSelect } from './components/fields/SaberSelect.vue';
+export { default as SaberTextarea } from './components/fields/SaberTextarea.vue';
+export { default as SaberPopSelect } from './components/fields/SaberPopSelect.vue';
+export { default as SaberDistrictSelect } from './components/fields/SaberDistrictSelect.vue';
+export { default as SaberUploadImage } from './components/fields/SaberUploadImage.vue';
+export { hasActiveFilterValues, hasMeaningfulValue, isSameFormValue } from './filter-state';
+export { DictDataSourceKey } from './dict-source';
+export { UploadImageDataSourceKey } from './upload-image-source';
+export { createAmapDistrictDataSource, createDistrictService, DistrictServiceKey, resolveDistrictDataSource, useDistrictService, } from './district-service';
+export type { AmapDistrictDataSourceOptions, DistrictDataSource, DistrictService, ResolvedDistrict, SaberDistrictOptions, } from './district-service';
+export { useDictOptions } from './use-dict-options';
+export { installSaberForms, type SaberFormsOptions } from './plugin';
+export { createFormRegistry, FormRegistryKey, resolveFormComponent, useFormRegistry, type FormRegistry, } from './registry';
+export { basicFormComponents, basicGlobalFormComponents } from './presets/basic';
+export type { BuiltinFormComponentKey, DictDataSource, DictOption, DistrictNode, DistrictValue, FilterField, FilterSearchOn, FormComponentKey, FormComponentMap, FormComponentReference, FormField, FormSubmitHandler, FormValidationError, FormValidator, OptionalFormComponentKey, PopSelectOption, UploadImageContext, UploadImageDataSource, UploadImageModelValue, UploadImageRemoveContext, } from './types';

package/dist/forms/plugin.d.ts

@@ -0,0 +1,20 @@
+import { App } from 'vue';
+import { SaberDistrictOptions } from './district-service';
+import { FormRegistry } from './registry';
+import { DictDataSource, FormComponentMap, UploadImageDataSource } from './types';
+export interface SaberFormsOptions {
+    /** 在默认字段之外注册或覆盖字段。 */
+    components?: FormComponentMap;
+    /** 为 SaberDict* 字段提供项目侧的字典加载与缓存适配。 */
+    dictDataSource?: DictDataSource;
+    /** 为按需使用的 SaberUploadImage 提供项目侧上传与删除适配。 */
+    uploadImageDataSource?: UploadImageDataSource<any>;
+    /** 配置共享行政区划服务；可只传高德 Web 服务 Key，也可替换为自定义数据源。 */
+    district?: SaberDistrictOptions;
+}
+/**
+ * 为某个 Vue app 安装 Saber forms。
+ *
+ * 该函数由 SaberUI 默认调用，也可供只需要 forms 的项目单独使用。
+ */
+export declare function installSaberForms(app: App, options?: SaberFormsOptions): FormRegistry;

package/dist/forms/pop-select.mjs

@@ -0,0 +1,4 @@
+import { _ as f } from "../SaberPopSelect.vue_vue_type_script_setup_true_lang-BcS27NXI.js";
+export {
+  f as default
+};

package/dist/forms/presets/basic.d.ts

@@ -0,0 +1,5 @@
+import { FormComponentMap } from '../types';
+/** 随 `app.use(SaberUI)` 默认安装的轻量字段。 */
+export declare const basicFormComponents: FormComponentMap;
+/** 需要作为全局模板组件暴露的 Saber 字段。 */
+export declare const basicGlobalFormComponents: FormComponentMap;

package/dist/forms/registry.d.ts

@@ -0,0 +1,15 @@
+import { Component, InjectionKey } from 'vue';
+import { FormComponentMap, FormComponentReference } from './types';
+export interface FormRegistry {
+    register(key: string, component: Component): void;
+    registerMany(components: FormComponentMap): void;
+    resolve(key: string): Component | undefined;
+    has(key: string): boolean;
+}
+export declare const FormRegistryKey: InjectionKey<FormRegistry>;
+/** 创建独立的字段注册表；每个 Vue app 应拥有自己的实例。 */
+export declare function createFormRegistry(initialComponents?: FormComponentMap): FormRegistry;
+/** 在 Saber forms 组件中读取当前 app 的注册表。 */
+export declare function useFormRegistry(): FormRegistry | undefined;
+/** 将 field.which 解析为可渲染组件。 */
+export declare function resolveFormComponent(registry: FormRegistry | undefined, reference: FormComponentReference): Component;

package/dist/forms/types.d.ts

@@ -0,0 +1,102 @@
+import { Component } from 'vue';
+/** 已由 saber-ui 内置提供的字段 key。 */
+export type BuiltinFormComponentKey = 'saber-input' | 'saber-input-number' | 'saber-dict-checkbox' | 'saber-dict-radio' | 'saber-dict-select' | 'saber-district-select' | 'saber-pop-select' | 'saber-select' | 'saber-textarea' | 'saber-radio-group' | 'ui-input' | 'ui-input-number' | 'ui-select' | 'ui-textarea' | 'ui-radio-group';
+/** saber-ui 提供、但不会随默认 registry 注册的按需字段 key。 */
+export type OptionalFormComponentKey = 'saber-upload-image';
+/**
+ * 字段注册 key。
+ *
+ * 保留内置 key 的自动补全，同时允许宿主项目注册自己的字段。
+ */
+export type FormComponentKey = BuiltinFormComponentKey | OptionalFormComponentKey | (string & {});
+/** 字段既可以引用注册 key，也可在一次性场景直接传 Vue 组件。 */
+export type FormComponentReference = FormComponentKey | Component;
+export type FormComponentMap = Record<string, Component>;
+/** PopSelect 组件选项。 */
+export interface PopSelectOption<T = unknown> {
+    label: string;
+    value: T;
+    disabled?: boolean;
+}
+/** 字典字段消费的标准选项；允许保留业务侧附加元数据。 */
+export interface DictOption<T = string | number> {
+    label: string;
+    value: T;
+    disabled?: boolean;
+    [key: string]: unknown;
+}
+/**
+ * 字典数据源由宿主项目实现。
+ * 请求、缓存、租户隔离和后端数据转换均由宿主负责，saber-ui 只负责调用和渲染。
+ */
+export interface DictDataSource {
+    loadOptions(dictType: string): readonly DictOption[] | Promise<readonly DictOption[]>;
+}
+export interface UploadImageContext {
+    onProgress(percent: number): void;
+    signal: AbortSignal;
+}
+export interface UploadImageRemoveContext {
+    /** initial 表示表单初始值，uploaded 表示当前组件实例中新上传的文件。 */
+    origin: 'initial' | 'uploaded';
+}
+/**
+ * 图片上传适配器。T 完全由宿主定义，组件通过 getKey/getUrl 读取必要字段。
+ */
+export interface UploadImageDataSource<T = unknown> {
+    upload(file: File, context: UploadImageContext): Promise<T>;
+    remove?(value: T, context: UploadImageRemoveContext): Promise<void>;
+    getKey(value: T): string | number;
+    getUrl(value: T): string;
+    getName?(value: T): string;
+}
+export type UploadImageModelValue<T = unknown> = T | T[] | null;
+/** 通用行政区划树节点。 */
+export interface DistrictNode {
+    name: string;
+    adcode: string;
+    citycode?: string;
+    level: 'province' | 'city' | 'district' | 'street';
+    districts?: DistrictNode[];
+}
+/** DistrictSelect 的标准选中值。 */
+export interface DistrictValue {
+    province: string;
+    provinceCode: string;
+    city: string;
+    cityCode: string;
+    district: string;
+    districtCode: string;
+}
+export type FilterSearchOn = 'change' | 'update:model-value' | 'manual';
+export interface FilterField {
+    /** 对应筛选参数对象中的字段名。 */
+    key: string;
+    /** 已注册字段的 key，或一次性传入的 Vue 组件。 */
+    which: FormComponentReference;
+    /** 透传给字段组件的 props / attrs。 */
+    props?: Record<string, unknown>;
+    /** 附加到字段组件根节点的 class。 */
+    class?: string;
+    /** 控制该字段何时触发 FilterBar 的 search 事件。 */
+    searchOn?: FilterSearchOn;
+}
+export interface FormField<T extends Record<string, unknown> = Record<string, unknown>> {
+    /** 对应表单状态中的字段名。 */
+    key: Extract<keyof T, string> | string;
+    /** UFormField 标签。 */
+    label?: string;
+    /** 已注册字段的 key，或一次性传入的 Vue 组件。 */
+    which: FormComponentReference;
+    /** 透传给字段组件的 props / attrs。 */
+    props?: Record<string, unknown>;
+    /** 附加到 UFormField 的 class。 */
+    class?: string;
+}
+/** 与 Nuxt UI UForm 的校验结果兼容的最小错误结构。 */
+export interface FormValidationError {
+    name?: string;
+    message: string;
+}
+export type FormValidator<T extends Record<string, unknown>> = (state: T) => FormValidationError[] | void | Promise<FormValidationError[] | void>;
+export type FormSubmitHandler<T extends Record<string, unknown>> = (state: T) => unknown | Promise<unknown>;

package/dist/forms/upload-image-source.d.ts

@@ -0,0 +1,3 @@
+import { InjectionKey } from 'vue';
+import { UploadImageDataSource } from './types';
+export declare const UploadImageDataSourceKey: InjectionKey<UploadImageDataSource<any>>;

package/dist/forms/upload-image.mjs

@@ -0,0 +1,4 @@
+import { _ as f } from "../SaberUploadImage.vue_vue_type_script_setup_true_lang-CAwci2Vr.js";
+export {
+  f as default
+};

package/dist/forms/use-dict-options.d.ts

@@ -0,0 +1,8 @@
+import { Ref } from 'vue';
+import { DictDataSource, DictOption } from './types';
+/** 为字典字段加载标准选项，并避免 dictType 快速切换造成旧请求覆盖新数据。 */
+export declare function useDictOptions(dictType: Readonly<Ref<string>>, dataSourceOverride: Readonly<Ref<DictDataSource | undefined>>): {
+    items: import('vue').ShallowRef<DictOption<string | number>[], DictOption<string | number>[]>;
+    loading: Ref<boolean, boolean>;
+    error: import('vue').ShallowRef<unknown, unknown>;
+};

package/dist/forms.mjs

@@ -0,0 +1,45 @@
+import { F as r, _ as s, a as o, b as t, c as i, d as c, e as m, f as S, g as p, h as b, i as l, j as u, k as D, l as f, r as x, u as n } from "./plugin-Dr3z0YFg.js";
+import { _ } from "./SaberModal.vue_vue_type_script_setup_true_lang-DJno3jA3.js";
+import { _ as g } from "./SaberDictCheckbox.vue_vue_type_script_setup_true_lang-DUbzy_C6.js";
+import { _ as v, a as R } from "./SaberDictRadio.vue_vue_type_script_setup_true_lang-DR6-jSID.js";
+import { _ as C } from "./SaberDictSelect.vue_vue_type_script_setup_true_lang-B8PTKNKX.js";
+import { _ as K } from "./SaberPopSelect.vue_vue_type_script_setup_true_lang-BcS27NXI.js";
+import { _ as U } from "./SaberDistrictSelect.vue_vue_type_script_setup_true_lang-BX8nLC35.js";
+import { _ as k } from "./SaberUploadImage.vue_vue_type_script_setup_true_lang-CAwci2Vr.js";
+import { D as G, u as j } from "./use-dict-options-DjtbYYIa.js";
+import { U as N } from "./upload-image-source-On8NHgmx.js";
+import { D as P, c as T, a as q, r as w, u as z } from "./district-service-cOu1tbQG.js";
+export {
+  G as DictDataSourceKey,
+  P as DistrictServiceKey,
+  r as FormRegistryKey,
+  g as SaberDictCheckbox,
+  v as SaberDictRadio,
+  C as SaberDictSelect,
+  U as SaberDistrictSelect,
+  s as SaberFilterBar,
+  o as SaberFormModal,
+  t as SaberInput,
+  i as SaberInputNumber,
+  _ as SaberModal,
+  K as SaberPopSelect,
+  R as SaberRadioGroup,
+  c as SaberSelect,
+  m as SaberTextarea,
+  k as SaberUploadImage,
+  N as UploadImageDataSourceKey,
+  S as basicFormComponents,
+  p as basicGlobalFormComponents,
+  T as createAmapDistrictDataSource,
+  q as createDistrictService,
+  b as createFormRegistry,
+  l as hasActiveFilterValues,
+  u as hasMeaningfulValue,
+  D as installSaberForms,
+  f as isSameFormValue,
+  w as resolveDistrictDataSource,
+  x as resolveFormComponent,
+  j as useDictOptions,
+  z as useDistrictService,
+  n as useFormRegistry
+};

package/dist/index.d.ts

@@ -1,6 +1,67 @@
 import { Plugin } from 'vue';
 import { default as BadgeStatus } from './BadgeStatus.vue';
+import { default as SaberNoData } from './SaberNoData.vue';
+import { default as SaberConfirmModal } from './components/SaberConfirmModal.vue';
+import { default as SaberConfirmProvider } from './components/SaberConfirmProvider.vue';
+import { default as SaberInfo } from './components/SaberInfo.vue';
+import { default as SaberInfoProvider } from './components/SaberInfoProvider.vue';
+import { default as SaberModalWithMobile } from './components/SaberModalWithMobile.vue';
+import { default as SaberStatus } from './components/SaberStatus.vue';
+import { default as SaberSwitchBar } from './components/SaberSwitchBar.vue';
+import { default as SaberFilterBar } from './forms/components/SaberFilterBar.vue';
+import { default as SaberFormModal } from './forms/components/SaberFormModal.vue';
+import { default as SaberModal } from './forms/components/SaberModal.vue';
+import { default as SaberInput } from './forms/components/fields/SaberInput.vue';
+import { default as SaberInputNumber } from './forms/components/fields/SaberInputNumber.vue';
+import { default as SaberDictCheckbox } from './forms/components/fields/SaberDictCheckbox.vue';
+import { default as SaberDictRadio } from './forms/components/fields/SaberDictRadio.vue';
+import { default as SaberDictSelect } from './forms/components/fields/SaberDictSelect.vue';
+import { default as SaberDistrictSelect } from './forms/components/fields/SaberDistrictSelect.vue';
+import { default as SaberPopSelect } from './forms/components/fields/SaberPopSelect.vue';
+import { default as SaberRadioGroup } from './forms/components/fields/SaberRadioGroup.vue';
+import { default as SaberSelect } from './forms/components/fields/SaberSelect.vue';
+import { default as SaberTextarea } from './forms/components/fields/SaberTextarea.vue';
+import { SaberFormsOptions } from './forms/plugin';
+export interface SaberUIOptions {
+    forms?: SaberFormsOptions;
+}
 declare const SaberUI: Plugin;
 export default SaberUI;
-export { BadgeStatus };
+export { BadgeStatus as SaberBadgeStatus };
 export type { BadgeStatusProps } from './BadgeStatus.types';
+export { SaberNoData };
+export type { SaberNoDataProps } from './SaberNoData.types';
+export { SaberConfirmModal, SaberConfirmProvider, SaberInfo, SaberInfoProvider, SaberModalWithMobile, SaberStatus, SaberSwitchBar, };
+export type { SaberInfoContext, SaberInfoMode, SaberInfoProps, SaberInfoVariant } from './components/SaberInfo.types';
+export type { SaberStatusType } from './components/SaberStatus.types';
+export type { SaberSwitchBarItem, SaberSwitchBarUI, SaberSwitchBarValue } from './components/SaberSwitchBar.types';
+export { SaberFilterBar, SaberFormModal, SaberDictCheckbox, SaberDictRadio, SaberDictSelect, SaberDistrictSelect, SaberInput, SaberInputNumber, SaberModal, SaberPopSelect, SaberRadioGroup, SaberSelect, SaberTextarea, };
+export { installSaberForms, type SaberFormsOptions } from './forms/plugin';
+export type { DictDataSource, DictOption, FilterField, FormField, FormSubmitHandler, FormValidator } from './forms/types';
+export type { DistrictDataSource, SaberDistrictOptions } from './forms/district-service';
+declare module 'vue' {
+    interface GlobalComponents {
+        SaberBadgeStatus: typeof BadgeStatus;
+        SaberNoData: typeof SaberNoData;
+        SaberConfirmModal: typeof SaberConfirmModal;
+        SaberConfirmProvider: typeof SaberConfirmProvider;
+        SaberInfo: typeof SaberInfo;
+        SaberInfoProvider: typeof SaberInfoProvider;
+        SaberModalWithMobile: typeof SaberModalWithMobile;
+        SaberStatus: typeof SaberStatus;
+        SaberSwitchBar: typeof SaberSwitchBar;
+        SaberFilterBar: typeof SaberFilterBar;
+        SaberFormModal: typeof SaberFormModal;
+        SaberModal: typeof SaberModal;
+        SaberDictCheckbox: typeof SaberDictCheckbox;
+        SaberDictRadio: typeof SaberDictRadio;
+        SaberDictSelect: typeof SaberDictSelect;
+        SaberDistrictSelect: typeof SaberDistrictSelect;
+        SaberInput: typeof SaberInput;
+        SaberInputNumber: typeof SaberInputNumber;
+        SaberPopSelect: typeof SaberPopSelect;
+        SaberRadioGroup: typeof SaberRadioGroup;
+        SaberSelect: typeof SaberSelect;
+        SaberTextarea: typeof SaberTextarea;
+    }
+}