@composy/store-vue 0.0.1

package/es/types.d.ts

@@ -0,0 +1,167 @@
+import type { Pinia } from 'pinia';
+import type { Ref } from 'vue';
+/**
+ * Store 基础配置选项
+ * @property persist - 持久化配置，true 使用默认配置，或传入 PersistOptions 对象
+ * @property devtools - 是否启用 Vue DevTools 支持
+ * @property strict - 是否启用严格模式（如 Pinia 的 $patch 严格检查）
+ */
+export interface StoreOptions {
+    persist?: boolean | PersistOptions;
+    devtools?: boolean;
+    strict?: boolean;
+}
+/**
+ * 持久化配置选项
+ * 控制 Pinia Store 状态如何被保存到浏览器存储
+ * @property key - 自定义存储键名（默认使用 store.$id）
+ * @property storage - 存储类型：'localStorage' 或 'sessionStorage'
+ * @property paths - 只持久化指定路径的状态（白名单模式）
+ * @property excludePaths - 排除指定路径不持久化（黑名单模式）
+ * @property debounce - 防抖延迟（毫秒），避免频繁写入
+ * @property syncTabs - 是否跨标签页同步状态
+ * @property ttl - 存活时间（毫秒），过期后自动清除
+ * @property serializer - 自定义序列化/反序列化函数
+ * @property beforeRestore - 恢复前钩子
+ * @property afterRestore - 恢复后钩子
+ */
+export interface PersistOptions {
+    key?: string;
+    storage?: 'localStorage' | 'sessionStorage';
+    paths?: string[];
+    excludePaths?: string[];
+    debounce?: number;
+    syncTabs?: boolean;
+    ttl?: number;
+    serializer?: {
+        serialize: (value: unknown) => string;
+        deserialize: (value: string) => unknown;
+    };
+    beforeRestore?: (context: {
+        store: unknown;
+    }) => void;
+    afterRestore?: (context: {
+        store: unknown;
+    }) => void;
+}
+/**
+ * Store Engine 插件配置选项
+ * 控制 Store 引擎插件的行为
+ * @property name - 插件名称
+ * @property version - 插件版本
+ * @property dependencies - 依赖的其他插件列表
+ * @property persist - 是否启用持久化
+ * @property persistOptions - 持久化配置选项
+ * @property devtools - 是否启用 DevTools
+ * @property debug - 是否开启调试日志
+ * @property globalProperties - 是否挂载到 app.config.globalProperties
+ * @property provide - 是否通过 Vue provide/inject 注入
+ * @property pinia - 外部传入的 Pinia 实例（可选，不传则自动创建）
+ */
+export interface StoreEnginePluginOptions {
+    name?: string;
+    version?: string;
+    dependencies?: string[];
+    persist?: boolean;
+    persistOptions?: PersistOptions;
+    devtools?: boolean;
+    debug?: boolean;
+    globalProperties?: boolean;
+    provide?: boolean;
+    pinia?: Pinia;
+}
+/**
+ * useStore 返回值接口
+ * 提供响应式状态和常用操作方法
+ * @property state - 响应式状态引用
+ * @property reset - 重置状态到初始值
+ * @property patch - 部分更新状态（支持对象或函数）
+ * @property store - 底层 Pinia Store 实例
+ */
+export interface UseStoreReturn<S = unknown> {
+    state: Ref<S>;
+    reset: () => void;
+    patch: (partial: Partial<S> | ((state: S) => void)) => void;
+    store: unknown;
+}
+/**
+ * usePersist 配置选项
+ * 简化版的持久化选项，用于 composable 场景
+ * @property key - 存储键名
+ * @property storage - 存储类型
+ * @property defaultValue - 默认值
+ * @property serialize - 自定义序列化函数
+ * @property deserialize - 自定义反序列化函数
+ */
+export interface UsePersistOptions {
+    key: string;
+    storage?: 'localStorage' | 'sessionStorage';
+    defaultValue?: unknown;
+    serialize?: (value: unknown) => string;
+    deserialize?: (value: string) => unknown;
+}
+/**
+ * usePersist 返回值接口
+ * @property value - 持久化的响应式引用
+ * @property save - 手动保存
+ * @property restore - 从存储恢复
+ * @property clear - 清除存储
+ */
+export interface UsePersistReturn<T> {
+    value: Ref<T>;
+    save: () => void;
+    restore: () => void;
+    clear: () => void;
+}
+/**
+ * 订阅选项接口
+ * 控制 Store 订阅行为
+ * @property immediate - 是否立即触发一次回调
+ * @property deep - 是否深度监听
+ * @property detached - 是否脱离当前组件生命周期（组件卸载后继续监听）
+ */
+export interface SubscribeOptions {
+    immediate?: boolean;
+    deep?: boolean;
+    detached?: boolean;
+}
+/**
+ * 变更信息接口
+ * 描述 Store 状态变更的详细信息
+ * @property type - 变更类型：'direct'（直接赋值）、'patch object'（对象补丁）、'patch function'（函数补丁）
+ * @property storeId - Store ID
+ * @property events - 触发的事件列表
+ * @property oldState - 变更前的状态（部分）
+ */
+export interface MutationInfo<S = unknown> {
+    type: 'direct' | 'patch object' | 'patch function';
+    storeId: string;
+    events?: string[];
+    oldState?: Partial<S>;
+}
+/**
+ * Store Provider 组件 Props
+ * @property pinia - Pinia 实例
+ * @property children - 子组件（React 风格，Vue 中较少使用）
+ */
+export interface StoreProviderProps {
+    pinia?: Pinia;
+    children?: unknown;
+}
+/**
+ * 全局 Store API 接口
+ * 提供只读的 Store 查询和管理能力
+ * @property pinia - Pinia 实例引用
+ * @property getStore - 获取指定 ID 的 Store
+ * @property hasStore - 检查 Store 是否存在
+ * @property getStoreIds - 获取所有已注册的 Store ID
+ * @property resetAll - 重置所有 Store 到初始状态
+ */
+export interface GlobalStoreAPI {
+    pinia: Pinia;
+    getStore: <T>(id: string) => T | undefined;
+    hasStore: (id: string) => boolean;
+    getStoreIds: () => string[];
+    resetAll: () => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/es/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/es/types.js

@@ -0,0 +1,10 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+/*! End of @composy/store-vue | Powered by @composy/builder */

package/esm/composables/defineSetupStore.d.ts

@@ -0,0 +1,120 @@
+/**
+ * defineSetupStore - Setup 风格 Store 定义助手
+ *
+ * 提供更简洁的 composition API 风格来定义 Pinia Store。
+ * 本质是对 defineStore 的 setup 语法的薄封装，增加类型推断和开发体验。
+ *
+ * @module composables/defineSetupStore
+ */
+import type { ComputedRef, Ref } from 'vue';
+/**
+ * defineSetupStore - 使用 Composition API 风格定义 Store
+ *
+ * 与 defineStore 的 setup 语法等价，但提供更清晰的语义。
+ * 适合喜欢 Composition API 风格的开发者。
+ *
+ * @param id - Store 唯一标识
+ * @param setup - Setup 函数（在函数内使用 ref、computed、普通函数来定义 state、getters、actions）
+ * @returns Pinia Store 定义
+ *
+ * @example
+ * ```typescript
+ * import { defineSetupStore } from '@composy/store-vue'
+ * import { ref, computed } from 'vue'
+ *
+ * // Setup 风格定义（推荐）
+ * export const useCounterStore = defineSetupStore('counter', () => {
+ *   // state（使用 ref）
+ *   const count = ref(0)
+ *   const step = ref(1)
+ *
+ *   // getters（使用 computed）
+ *   const doubleCount = computed(() => count.value * 2)
+ *   const isPositive = computed(() => count.value > 0)
+ *
+ *   // actions（普通函数）
+ *   function increment() {
+ *     count.value += step.value
+ *   }
+ *
+ *   function decrement() {
+ *     count.value -= step.value
+ *   }
+ *
+ *   async function fetchCount(id: string) {
+ *     const res = await fetch(`/api/count/${id}`)
+ *     count.value = await res.json()
+ *   }
+ *
+ *   function reset() {
+ *     count.value = 0
+ *     step.value = 1
+ *   }
+ *
+ *   return {
+ *     count, step,
+ *     doubleCount, isPositive,
+ *     increment, decrement, fetchCount, reset,
+ *   }
+ * })
+ * ```
+ */
+export declare function defineSetupStore<T>(id: string, setup: () => T): import("pinia").StoreDefinition<string, import("pinia")._ExtractStateFromSetupStore<T>, import("pinia")._ExtractGettersFromSetupStore<T>, import("pinia")._ExtractActionsFromSetupStore<T>>;
+/**
+ * createStoreState - 创建带有类型推断的 Store State
+ *
+ * 工具函数，帮助在 setup store 中快速创建多个 ref 状态。
+ *
+ * @param initial - 初始状态对象
+ * @returns 以 ref 包装的响应式状态对象
+ *
+ * @example
+ * ```typescript
+ * const useUserStore = defineSetupStore('user', () => {
+ *   const state = createStoreState({
+ *     name: '张三',
+ *     age: 25,
+ *     email: '',
+ *   })
+ *
+ *   // state.name 是 Ref<string>
+ *   // state.age 是 Ref<number>
+ *
+ *   function updateName(name: string) {
+ *     state.name.value = name
+ *   }
+ *
+ *   return { ...state, updateName }
+ * })
+ * ```
+ */
+export declare function createStoreState<T extends Record<string, unknown>>(initial: T): {
+    [K in keyof T]: Ref<T[K]>;
+};
+/**
+ * createStoreGetters - 创建带有类型推断的 Store Getters
+ *
+ * 工具函数，帮助在 setup store 中快速创建多个 computed getter。
+ *
+ * @param getters - getter 函数映射
+ * @returns 以 computed 包装的响应式 getter 对象
+ *
+ * @example
+ * ```typescript
+ * const useUserStore = defineSetupStore('user', () => {
+ *   const name = ref('张三')
+ *   const age = ref(25)
+ *
+ *   const getters = createStoreGetters({
+ *     displayName: () => `${name.value} (${age.value}岁)`,
+ *     isAdult: () => age.value >= 18,
+ *   })
+ *
+ *   return { name, age, ...getters }
+ * })
+ * ```
+ */
+export declare function createStoreGetters<T extends Record<string, () => unknown>>(getters: T): {
+    [K in keyof T]: ComputedRef<ReturnType<T[K]>>;
+};
+//# sourceMappingURL=defineSetupStore.d.ts.map

package/esm/composables/defineSetupStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSetupStore.d.ts","sourceRoot":"","sources":["../../src/composables/defineSetupStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAC,WAAW,EAAE,GAAG,EAAC,MAAM,KAAK,CAAC;AAI1C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAChC,EAAE,EAAE,MAAM,EACV,KAAK,EAAE,MAAM,CAAC,+LAGf;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAChE,OAAO,EAAE,CAAC,GACT;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAM/B;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,EACxE,OAAO,EAAE,CAAC,GACT;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,CAMnD"}

package/esm/composables/defineSetupStore.js

@@ -0,0 +1,29 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { defineStore } from "pinia";
+import { computed, ref } from "vue";
+//#region src/composables/defineSetupStore.ts
+function defineSetupStore(id, setup) {
+	return defineStore(id, setup);
+}
+function createStoreState(initial) {
+	const result = {};
+	for (const key of Object.keys(initial)) result[key] = ref(initial[key]);
+	return result;
+}
+function createStoreGetters(getters) {
+	const result = {};
+	for (const key of Object.keys(getters)) result[key] = computed(getters[key]);
+	return result;
+}
+//#endregion
+export { createStoreGetters, createStoreState, defineSetupStore };
+/*! End of @composy/store-vue | Powered by @composy/builder */
+//# sourceMappingURL=defineSetupStore.js.map

package/esm/composables/defineSetupStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"defineSetupStore.js","names":[],"sources":["../../src/composables/defineSetupStore.ts"],"sourcesContent":["/**\n * defineSetupStore - Setup 风格 Store 定义助手\n *\n * 提供更简洁的 composition API 风格来定义 Pinia Store。\n * 本质是对 defineStore 的 setup 语法的薄封装，增加类型推断和开发体验。\n *\n * @module composables/defineSetupStore\n */\n\nimport type {ComputedRef, Ref} from 'vue';\nimport { defineStore } from 'pinia'\nimport { computed,  ref  } from 'vue'\n\n/**\n * defineSetupStore - 使用 Composition API 风格定义 Store\n *\n * 与 defineStore 的 setup 语法等价，但提供更清晰的语义。\n * 适合喜欢 Composition API 风格的开发者。\n *\n * @param id - Store 唯一标识\n * @param setup - Setup 函数（在函数内使用 ref、computed、普通函数来定义 state、getters、actions）\n * @returns Pinia Store 定义\n *\n * @example\n * ```typescript\n * import { defineSetupStore } from '@composy/store-vue'\n * import { ref, computed } from 'vue'\n *\n * // Setup 风格定义（推荐）\n * export const useCounterStore = defineSetupStore('counter', () => {\n *   // state（使用 ref）\n *   const count = ref(0)\n *   const step = ref(1)\n *\n *   // getters（使用 computed）\n *   const doubleCount = computed(() => count.value * 2)\n *   const isPositive = computed(() => count.value > 0)\n *\n *   // actions（普通函数）\n *   function increment() {\n *     count.value += step.value\n *   }\n *\n *   function decrement() {\n *     count.value -= step.value\n *   }\n *\n *   async function fetchCount(id: string) {\n *     const res = await fetch(`/api/count/${id}`)\n *     count.value = await res.json()\n *   }\n *\n *   function reset() {\n *     count.value = 0\n *     step.value = 1\n *   }\n *\n *   return {\n *     count, step,\n *     doubleCount, isPositive,\n *     increment, decrement, fetchCount, reset,\n *   }\n * })\n * ```\n */\nexport function defineSetupStore<T>(\n  id: string,\n  setup: () => T,\n) {\n  return defineStore(id, setup)\n}\n\n/**\n * createStoreState - 创建带有类型推断的 Store State\n *\n * 工具函数，帮助在 setup store 中快速创建多个 ref 状态。\n *\n * @param initial - 初始状态对象\n * @returns 以 ref 包装的响应式状态对象\n *\n * @example\n * ```typescript\n * const useUserStore = defineSetupStore('user', () => {\n *   const state = createStoreState({\n *     name: '张三',\n *     age: 25,\n *     email: '',\n *   })\n *\n *   // state.name 是 Ref<string>\n *   // state.age 是 Ref<number>\n *\n *   function updateName(name: string) {\n *     state.name.value = name\n *   }\n *\n *   return { ...state, updateName }\n * })\n * ```\n */\nexport function createStoreState<T extends Record<string, unknown>>(\n  initial: T,\n): { [K in keyof T]: Ref<T[K]> } {\n  const result = {} as { [K in keyof T]: Ref<T[K]> }\n  for (const key of Object.keys(initial) as Array<keyof T>) {\n    result[key] = ref(initial[key]) as Ref<T[typeof key]>\n  }\n  return result\n}\n\n/**\n * createStoreGetters - 创建带有类型推断的 Store Getters\n *\n * 工具函数，帮助在 setup store 中快速创建多个 computed getter。\n *\n * @param getters - getter 函数映射\n * @returns 以 computed 包装的响应式 getter 对象\n *\n * @example\n * ```typescript\n * const useUserStore = defineSetupStore('user', () => {\n *   const name = ref('张三')\n *   const age = ref(25)\n *\n *   const getters = createStoreGetters({\n *     displayName: () => `${name.value} (${age.value}岁)`,\n *     isAdult: () => age.value >= 18,\n *   })\n *\n *   return { name, age, ...getters }\n * })\n * ```\n */\nexport function createStoreGetters<T extends Record<string, () => unknown>>(\n  getters: T,\n): { [K in keyof T]: ComputedRef<ReturnType<T[K]>> } {\n  const result = {} as { [K in keyof T]: ComputedRef<ReturnType<T[K]>> }\n  for (const key of Object.keys(getters) as Array<keyof T>) {\n    result[key] = computed(getters[key]) as ComputedRef<ReturnType<T[typeof key]>>\n  }\n  return result\n}\n"],"mappings":";;;;;;;;;;;;AAiEO,SAAS,iBACd,IACA,OACA;CACA,OAAO,YAAY,IAAI,KAAK;AAC9B;AA8BO,SAAS,iBACd,SAC+B;CAC/B,MAAM,SAAS,CAAC;CAChB,KAAA,MAAW,OAAO,OAAO,KAAK,OAAO,GACnC,OAAO,OAAO,IAAI,QAAQ,IAAI;CAEhC,OAAO;AACT;AAyBO,SAAS,mBACd,SACmD;CACnD,MAAM,SAAS,CAAC;CAChB,KAAA,MAAW,OAAO,OAAO,KAAK,OAAO,GACnC,OAAO,OAAO,SAAS,QAAQ,IAAI;CAErC,OAAO;AACT"}

package/esm/composables/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Composables 模块导出
+ *
+ * 提供 Vue 3 组合式 API 的 Store 工具函数
+ * @module composables
+ */
+export { createStoreGetters, createStoreState, defineSetupStore, } from './defineSetupStore';
+export { email, maxLength, minLength, numberRange, pattern, required, useFormStore, } from './useFormStore';
+export type { FormFieldRules, FormFieldState, FormValidator, UseFormStoreOptions, UseFormStoreReturn, } from './useFormStore';
+export { useOptimistic, } from './useOptimistic';
+export type { OptimisticEntry, UseOptimisticReturn, } from './useOptimistic';
+export { usePersist, usePersistedRef, usePersistedRefWithTTL, } from './usePersist';
+export { usePersistedState, } from './usePersistedState';
+export type { PersistedStateOptions, PersistedStateReturn, } from './usePersistedState';
+export { useSharedState, } from './useSharedState';
+export type { UseSharedStateOptions, UseSharedStateReturn, } from './useSharedState';
+export { useComputedStore, useSimpleStore, useStore, } from './useStore';
+export { useStoreDevtools, } from './useStoreDevtools';
+export type { EventLogEntry, StoreInfo, UseStoreDevtoolsReturn, } from './useStoreDevtools';
+export { useStoreSnapshot, } from './useStoreSnapshot';
+export type { StateDiff, StateSnapshot, UseStoreSnapshotOptions, UseStoreSnapshotReturn, } from './useStoreSnapshot';
+export { useOnAction, useSubscribe, useWatch, } from './useSubscribe';
+export type { ActionContext } from './useSubscribe';
+//# sourceMappingURL=index.d.ts.map

package/esm/composables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/composables/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EACL,kBAAkB,EAClB,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,KAAK,EACL,SAAS,EACT,SAAS,EACT,WAAW,EACX,OAAO,EACP,QAAQ,EACR,YAAY,GACb,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EACV,cAAc,EACd,cAAc,EACd,aAAa,EACb,mBAAmB,EACnB,kBAAkB,GACnB,MAAM,gBAAgB,CAAA;AAEvB,OAAO,EACL,aAAa,GACd,MAAM,iBAAiB,CAAA;AAExB,YAAY,EACV,eAAe,EACf,mBAAmB,GACpB,MAAM,iBAAiB,CAAA;AAExB,OAAO,EACL,UAAU,EACV,eAAe,EACf,sBAAsB,GACvB,MAAM,cAAc,CAAA;AAErB,OAAO,EACL,iBAAiB,GAClB,MAAM,qBAAqB,CAAA;AAE5B,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,qBAAqB,CAAA;AAE5B,OAAO,EACL,cAAc,GACf,MAAM,kBAAkB,CAAA;AAEzB,YAAY,EACV,qBAAqB,EACrB,oBAAoB,GACrB,MAAM,kBAAkB,CAAA;AAEzB,OAAO,EACL,gBAAgB,EAChB,cAAc,EACd,QAAQ,GACT,MAAM,YAAY,CAAA;AAEnB,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,aAAa,EACb,SAAS,EACT,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,gBAAgB,GACjB,MAAM,oBAAoB,CAAA;AAE3B,YAAY,EACV,SAAS,EACT,aAAa,EACb,uBAAuB,EACvB,sBAAsB,GACvB,MAAM,oBAAoB,CAAA;AAE3B,OAAO,EACL,WAAW,EACX,YAAY,EACZ,QAAQ,GACT,MAAM,gBAAgB,CAAA;AAEvB,YAAY,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAA"}

package/esm/composables/index.js

@@ -0,0 +1,21 @@
+/*!
+* ***********************************
+* @composy/store-vue v0.0.1       *
+* Built with rollup               *
+* Build time: 2024-08-17 11:39:29 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+import { createStoreGetters, createStoreState, defineSetupStore } from "./defineSetupStore.js";
+import { email, maxLength, minLength, numberRange, pattern, required, useFormStore } from "./useFormStore.js";
+import { useOptimistic } from "./useOptimistic.js";
+import { usePersist, usePersistedRef, usePersistedRefWithTTL } from "./usePersist.js";
+import { usePersistedState } from "./usePersistedState.js";
+import { useSharedState } from "./useSharedState.js";
+import { useComputedStore, useSimpleStore, useStore } from "./useStore.js";
+import { useStoreDevtools } from "./useStoreDevtools.js";
+import { useStoreSnapshot } from "./useStoreSnapshot.js";
+import { useOnAction, useSubscribe, useWatch } from "./useSubscribe.js";
+export { createStoreGetters, createStoreState, defineSetupStore, email, maxLength, minLength, numberRange, pattern, required, useComputedStore, useFormStore, useOnAction, useOptimistic, usePersist, usePersistedRef, usePersistedRefWithTTL, usePersistedState, useSharedState, useSimpleStore, useStore, useStoreDevtools, useStoreSnapshot, useSubscribe, useWatch };
+/*! End of @composy/store-vue | Powered by @composy/builder */

package/esm/composables/useFormStore.d.ts

@@ -0,0 +1,131 @@
+import type { ComputedRef, Ref } from 'vue';
+/**
+ * 表单校验器函数类型
+ * @param value - 当前字段值
+ * @param allValues - 表单所有字段的值（用于跨字段校验）
+ * @returns 校验错误信息或 null（无错误），支持异步校验
+ */
+export type FormValidator<T = unknown> = (value: T, allValues: Record<string, unknown>) => string | null | Promise<string | null>;
+/**
+ * 字段校验规则接口
+ * @property required - 是否必填，可传 string 自定义提示
+ * @property rules - 自定义校验器数组，按顺序依次执行
+ */
+export interface FormFieldRules<T = unknown> {
+    required?: boolean | string;
+    rules?: FormValidator<T>[];
+}
+/**
+ * useFormStore 的配置选项接口
+ * @property initialValues - 表单初始值（必须提供完整对象）
+ * @property validationRules - 各字段的校验规则映射
+ * @property onSubmit - 表单提交回调（校验通过后调用）
+ * @property validateOn - 触发校验的时机：'blur' | 'change' | 'submit'
+ */
+export interface UseFormStoreOptions<T extends Record<string, unknown>> {
+    initialValues: T;
+    validationRules?: {
+        [K in keyof T]?: FormFieldRules<T[K]>;
+    };
+    onSubmit?: (values: T) => void | Promise<void>;
+    validateOn?: 'blur' | 'change' | 'submit';
+}
+/**
+ * 单个字段的状态接口
+ * @property touched - 字段是否被触碰过（获得过焦点或提交过）
+ * @property dirty - 字段值是否与初始值不同（被修改过）
+ * @property error - 当前校验错误信息，null 表示无错误
+ * @property validating - 字段是否正在异步校验中
+ */
+export interface FormFieldState {
+    touched: boolean;
+    dirty: boolean;
+    error: string | null;
+    validating: boolean;
+}
+/**
+ * useFormStore 返回值接口
+ * @property values - 表单当前值（reactive 对象）
+ * @property fields - 各字段的状态映射
+ * @property isDirty - 是否有任意字段被修改过（计算属性）
+ * @property isValid - 是否所有字段都无校验错误（计算属性）
+ * @property isSubmitting - 表单是否正在提交中
+ * @property submitError - 提交失败的错误信息
+ * @property submitCount - 累计提交次数
+ * @property setFieldValue - 设置指定字段的值
+ * @property setFieldTouched - 标记字段为已触碰
+ * @property validateField - 校验单个字段（异步）
+ * @property validateAll - 校验所有字段（异步）
+ * @property handleSubmit - 提交表单
+ * @property reset - 重置整个表单（可传新的初始值）
+ * @property resetField - 重置单个字段
+ * @property errors - 所有字段错误信息的计算属性
+ */
+export interface UseFormStoreReturn<T extends Record<string, unknown>> {
+    values: T;
+    fields: Record<string, FormFieldState>;
+    isDirty: ComputedRef<boolean>;
+    isValid: ComputedRef<boolean>;
+    isSubmitting: Ref<boolean>;
+    submitError: Ref<string | null>;
+    submitCount: Ref<number>;
+    setFieldValue: <K extends keyof T>(field: K, value: T[K]) => void;
+    setFieldTouched: (field: keyof T) => void;
+    validateField: (field: keyof T) => Promise<string | null>;
+    validateAll: () => Promise<boolean>;
+    handleSubmit: () => Promise<void>;
+    reset: (newInitialValues?: Partial<T>) => void;
+    resetField: (field: keyof T) => void;
+    errors: ComputedRef<Record<string, string | null>>;
+}
+/**
+ * 表单状态管理 Composable
+ * 提供完整的表单生命周期管理能力，包括值管理、字段状态追踪、校验、提交和重置
+ *
+ * @param options - 表单配置选项
+ * @returns 包含表单状态和操作方法的对象
+ */
+export declare function useFormStore<T extends Record<string, unknown>>(options: UseFormStoreOptions<T>): UseFormStoreReturn<T>;
+/**
+ * 创建必填校验器
+ * @param message - 自定义错误提示，默认为 '此字段为必填项'
+ * @returns 校验器函数
+ */
+export declare function required(message?: string): FormValidator;
+/**
+ * 创建最小长度校验器
+ * @param min - 最小字符数
+ * @param message - 自定义错误提示
+ * @returns 字符串校验器函数
+ */
+export declare function minLength(min: number, message?: string): FormValidator<string>;
+/**
+ * 创建最大长度校验器
+ * @param max - 最大字符数
+ * @param message - 自定义错误提示
+ * @returns 字符串校验器函数
+ */
+export declare function maxLength(max: number, message?: string): FormValidator<string>;
+/**
+ * 创建正则匹配校验器
+ * @param regex - 正则表达式
+ * @param message - 自定义错误提示，默认为 '格式不正确'
+ * @returns 字符串校验器函数
+ */
+export declare function pattern(regex: RegExp, message?: string): FormValidator<string>;
+/**
+ * 创建邮箱格式校验器
+ * 基于内置的 EMAIL_PATTERN 正则
+ * @param message - 自定义错误提示，默认为 '邮箱格式不正确'
+ * @returns 字符串校验器函数
+ */
+export declare function email(message?: string): FormValidator<string>;
+/**
+ * 创建数值范围校验器
+ * @param min - 最小值
+ * @param max - 最大值
+ * @param message - 自定义错误提示
+ * @returns 数字校验器函数
+ */
+export declare function numberRange(min: number, max: number, message?: string): FormValidator<number>;
+//# sourceMappingURL=useFormStore.d.ts.map

package/esm/composables/useFormStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormStore.d.ts","sourceRoot":"","sources":["../../src/composables/useFormStore.ts"],"names":[],"mappings":"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"}